OpenAPI v3 Linting for APIMatic Portal Generation
Overview
Linting checks performed by APIMatic on provided OpenAPI v3 file to check its conformance to recommended practices for a more user-friendly API documentation.
Property | Value |
---|---|
Id | openapi-v3-docsgen-linting |
Code | OPENAPI3DOCSGEN_L |
Ruleset Type | Linting |
Default Severity of All Rules | Warning |
Rule System | Semantic |
Tags | documentation generation documentation docs openapi3 openapi semantic linting apimatic |
For More Information
- https://github.com/OAI/OpenAPI-Specification/blob/main/versions/3.0.3.md
- https://docs.apimatic.io/rulesets/overview/
Categories of Rules
- OpenAPI Root Information (OPENAPI3DOCSGEN_L001 - OPENAPI3DOCSGEN_L049)
- OpenAPI Info (OPENAPI3DOCSGEN_L050 - OPENAPI3DOCSGEN_L099)
- OpenAPI Contact (OPENAPI3DOCSGEN_L100 - OPENAPI3DOCSGEN_L129)
- OpenAPI Licenses (OPENAPI3DOCSGEN_L130 - OPENAPI3DOCSGEN_L149)
- OpenAPI Servers (OPENAPI3DOCSGEN_L150 - OPENAPI3DOCSGEN_L199)
- OpenAPI Components (OPENAPI3DOCSGEN_L200 - OPENAPI3DOCSGEN_L219)
- OpenAPI Paths (OPENAPI3DOCSGEN_L220 - OPENAPI3DOCSGEN_L239)
- OpenAPI Path Items (OPENAPI3DOCSGEN_L240 - OPENAPI3DOCSGEN_L299)
- OpenAPI Operations (OPENAPI3DOCSGEN_L300 - OPENAPI3DOCSGEN_L349)
- OpenAPI Operation Test Cases (OPENAPI3DOCSGEN_L350 - OPENAPI3DOCSGEN_L359)
- OpenAPI External Documentation (OPENAPI3DOCSGEN_L360 - OPENAPI3DOCSGEN_L379)
- OpenAPI Parameters (OPENAPI3DOCSGEN_L380 - OPENAPI3DOCSGEN_L429)
- OpenAPI Request Body (OPENAPI3DOCSGEN_L430 - OPENAPI3DOCSGEN_L459)
- OpenAPI Media Types (OPENAPI3DOCSGEN_L460 - OPENAPI3DOCSGEN_L509)
- OpenAPI Encoding (OPENAPI3DOCSGEN_L510 - OPENAPI3DOCSGEN_L519)
- OpenAPI Responses (OPENAPI3DOCSGEN_L520 - OPENAPI3DOCSGEN_L569)
- OpenAPI Callbacks (OPENAPI3DOCSGEN_L570 - OPENAPI3DOCSGEN_L589)
- OpenAPI Examples (OPENAPI3DOCSGEN_L590 - OPENAPI3DOCSGEN_L639)
- OpenAPI Links (OPENAPI3DOCSGEN_L640 - OPENAPI3DOCSGEN_L659)
- OpenAPI Headers (OPENAPI3DOCSGEN_L660 - OPENAPI3DOCSGEN_L709)
- OpenAPI Tags (OPENAPI3DOCSGEN_L710 - OPENAPI3DOCSGEN_L729)
- OpenAPI References (OPENAPI3DOCSGEN_L730 - OPENAPI3DOCSGEN_L749)
- OpenAPI Schemas (OPENAPI3DOCSGEN_L750 - OPENAPI3DOCSGEN_L799)
- OpenAPI Discriminators (OPENAPI3DOCSGEN_L800 - OPENAPI3DOCSGEN_L819)
- OpenAPI XML (OPENAPI3DOCSGEN_L820 - OPENAPI3DOCSGEN_L839)
- OpenAPI Security Schemes (OPENAPI3DOCSGEN_L840 - OPENAPI3DOCSGEN_L869)
- OpenAPI OAuth 2.0 Flows (OPENAPI3DOCSGEN_L870 - OPENAPI3DOCSGEN_L879)
- OpenAPI Security Requirements (OPENAPI3DOCSGEN_L880 - OPENAPI3DOCSGEN_L899)
- Miscellaneous (OPENAPI3DOCSGEN_L900 - OPENAPI3DOCSGEN_L999)
OpenAPI Info Rules
OpenAPI Servers Rules
- environment-description-exists (OPENAPI3DOCSGEN_L150)
- server-description-exists (OPENAPI3DOCSGEN_L151)
- server-variable-description-exists (OPENAPI3DOCSGEN_L152)
- server-parameter-description-exists (OPENAPI3DOCSGEN_L153)
OpenAPI Path Items Rules
OpenAPI Operations Rules
OpenAPI Parameters Rules
- parameter-description-exists (OPENAPI3DOCSGEN_L380)
- parameter-example-or-examples-exist (OPENAPI3DOCSGEN_L381)
- valid-parameter-example (OPENAPI3DOCSGEN_L382)
- non-empty-parameter-examples-key (OPENAPI3DOCSGEN_L385)
OpenAPI Request Body Rules
OpenAPI Media Types Rules
- mediaType-example-or-examples-exist (OPENAPI3DOCSGEN_L460)
- valid-media-type-example (OPENAPI3DOCSGEN_L461)
- non-empty-media-type-examples-key (OPENAPI3DOCSGEN_L463)
OpenAPI Responses Rules
OpenAPI Examples Rules
- example-summary-or-description-exists (OPENAPI3DOCSGEN_L590)
- example-value-or-external-value-present (OPENAPI3DOCSGEN_L592)
- valid-example-value (OPENAPI3DOCSGEN_L593)
OpenAPI Headers Rules
- header-description-exists (OPENAPI3DOCSGEN_L660)
- header-example-or-examples-exist (OPENAPI3DOCSGEN_L661)
- valid-header-example (OPENAPI3DOCSGEN_L662)
- non-empty-header-examples-key (OPENAPI3DOCSGEN_L664)
OpenAPI Tags Rules
OpenAPI Schemas Rules
- schema-description-exists (OPENAPI3DOCSGEN_L750)
- schema-example-or-default-value-exists (OPENAPI3DOCSGEN_L753)
- valid-schema-example (OPENAPI3DOCSGEN_L755)
- schema-example-equal-to-default-is-redundant (OPENAPI3DOCSGEN_L757)
OpenAPI Security Schemes Rules
- security-scheme-description-exists (OPENAPI3DOCSGEN_L840)
- additional-header-description-exists (OPENAPI3DOCSGEN_L841)