OpenAPI v3 Syntax Linting for APIMatic Portal Generation
Overview
Syntax 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-syntax-linting |
Code | OPENAPI3DOCSGENSYNTAX_L |
Ruleset Type | Linting |
Default Severity of All Rules | Warning |
Rule System | Syntax |
Products Impacted | Developer Experience Portal |
Tags | documentation generation documentation docs openapi3 openapi syntax 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 (OPENAPI3DOCSGENSYNTAX_L001 - OPENAPI3DOCSGENSYNTAX_L049)
- OpenAPI Info (OPENAPI3DOCSGENSYNTAX_L050 - OPENAPI3DOCSGENSYNTAX_L099)
- OpenAPI Contact (OPENAPI3DOCSGENSYNTAX_L100 - OPENAPI3DOCSGENSYNTAX_L129)
- OpenAPI Licenses (OPENAPI3DOCSGENSYNTAX_L130 - OPENAPI3DOCSGENSYNTAX_L149)
- OpenAPI Servers (OPENAPI3DOCSGENSYNTAX_L150 - OPENAPI3DOCSGENSYNTAX_L199)
- OpenAPI Components (OPENAPI3DOCSGENSYNTAX_L200 - OPENAPI3DOCSGENSYNTAX_L219)
- OpenAPI Paths (OPENAPI3DOCSGENSYNTAX_L220 - OPENAPI3DOCSGENSYNTAX_L239)
- OpenAPI Path Items (OPENAPI3DOCSGENSYNTAX_L240 - OPENAPI3DOCSGENSYNTAX_L299)
- OpenAPI Operations (OPENAPI3DOCSGENSYNTAX_L300 - OPENAPI3DOCSGENSYNTAX_L349)
- OpenAPI Operation Test Cases (OPENAPI3DOCSGENSYNTAX_L350 - OPENAPI3DOCSGENSYNTAX_L359)
- OpenAPI External Documentation (OPENAPI3DOCSGENSYNTAX_L360 - OPENAPI3DOCSGENSYNTAX_L379)
- OpenAPI Parameters (OPENAPI3DOCSGENSYNTAX_L380 - OPENAPI3DOCSGENSYNTAX_L429)
- OpenAPI Request Body (OPENAPI3DOCSGENSYNTAX_L430 - OPENAPI3DOCSGENSYNTAX_L459)
- OpenAPI Media Types (OPENAPI3DOCSGENSYNTAX_L460 - OPENAPI3DOCSGENSYNTAX_L509)
- OpenAPI Encoding (OPENAPI3DOCSGENSYNTAX_L510 - OPENAPI3DOCSGENSYNTAX_L519)
- OpenAPI Responses (OPENAPI3DOCSGENSYNTAX_L520 - OPENAPI3DOCSGENSYNTAX_L569)
- OpenAPI Callbacks (OPENAPI3DOCSGENSYNTAX_L570 - OPENAPI3DOCSGENSYNTAX_L589)
- OpenAPI Examples (OPENAPI3DOCSGENSYNTAX_L590 - OPENAPI3DOCSGENSYNTAX_L639)
- OpenAPI Links (OPENAPI3DOCSGENSYNTAX_L640 - OPENAPI3DOCSGENSYNTAX_L659)
- OpenAPI Headers (OPENAPI3DOCSGENSYNTAX_L660 - OPENAPI3DOCSGENSYNTAX_L709)
- OpenAPI Tags (OPENAPI3DOCSGENSYNTAX_L710 - OPENAPI3DOCSGENSYNTAX_L729)
- OpenAPI References (OPENAPI3DOCSGENSYNTAX_L730 - OPENAPI3DOCSGENSYNTAX_L749)
- OpenAPI Schemas (OPENAPI3DOCSGENSYNTAX_L750 - OPENAPI3DOCSGENSYNTAX_L799)
- OpenAPI Discriminators (OPENAPI3DOCSGENSYNTAX_L800 - OPENAPI3DOCSGENSYNTAX_L819)
- OpenAPI XML (OPENAPI3DOCSGENSYNTAX_L820 - OPENAPI3DOCSGENSYNTAX_L839)
- OpenAPI Security Schemes (OPENAPI3DOCSGENSYNTAX_L840 - OPENAPI3DOCSGENSYNTAX_L869)
- OpenAPI OAuth 2.0 Flows (OPENAPI3DOCSGENSYNTAX_L870 - OPENAPI3DOCSGENSYNTAX_L879)
- OpenAPI Security Requirements (OPENAPI3DOCSGENSYNTAX_L880 - OPENAPI3DOCSGENSYNTAX_L899)
- Miscellaneous (OPENAPI3DOCSGENSYNTAX_L900 - OPENAPI3DOCSGENSYNTAX_L999)
OpenAPI Info Rules
OpenAPI Servers Rules
- no-trailing-leading-spaces-in-environment-description (OPENAPI3DOCSGENSYNTAX_L150)
- no-trailing-leading-spaces-in-server-description (OPENAPI3DOCSGENSYNTAX_L151)
- no-trailing-leading-spaces-in-server-variable-description (OPENAPI3DOCSGENSYNTAX_L152)
- no-trailing-leading-spaces-in-server-parameter-description (OPENAPI3DOCSGENSYNTAX_L153)
OpenAPI Path Items Rules
- no-trailing-leading-spaces-in-path-item-description (OPENAPI3DOCSGENSYNTAX_L240)
- no-trailing-leading-spaces-in-path-item-summary (OPENAPI3DOCSGENSYNTAX_L241)
OpenAPI Operations Rules
- no-trailing-leading-spaces-in-operation-description (OPENAPI3DOCSGENSYNTAX_L300)
- no-trailing-leading-spaces-in-operation-summary (OPENAPI3DOCSGENSYNTAX_L301)
OpenAPI Operation Test Cases Rules
OpenAPI External Documentation Rules
OpenAPI Parameters Rules
- no-trailing-leading-spaces-in-parameter-description (OPENAPI3DOCSGENSYNTAX_L380)
- no-trailing-leading-spaces-in-parameter-example (OPENAPI3DOCSGENSYNTAX_L381)
OpenAPI Request Body Rules
OpenAPI Media Types Rules
OpenAPI Responses Rules
OpenAPI Examples Rules
- no-trailing-leading-spaces-in-example-description (OPENAPI3DOCSGENSYNTAX_L590)
- no-trailing-leading-spaces-in-example-summary (OPENAPI3DOCSGENSYNTAX_L591)
- no-trailing-leading-spaces-in-example-value (OPENAPI3DOCSGENSYNTAX_L592)
OpenAPI Links Rules
OpenAPI Headers Rules
- no-trailing-leading-spaces-in-header-description (OPENAPI3DOCSGENSYNTAX_L660)
- no-trailing-leading-spaces-in-header-example (OPENAPI3DOCSGENSYNTAX_L661)
OpenAPI Tags Rules
OpenAPI Schemas Rules
- no-trailing-leading-spaces-in-schema-description (OPENAPI3DOCSGENSYNTAX_L750)
- no-trailing-leading-spaces-in-one-of-cases-meta-description (OPENAPI3DOCSGENSYNTAX_L751)
- no-trailing-leading-spaces-in-any-of-cases-meta-description (OPENAPI3DOCSGENSYNTAX_L752)
- no-trailing-leading-spaces-in-schema-example (OPENAPI3DOCSGENSYNTAX_L753)
OpenAPI Security Schemes Rules
- no-trailing-leading-spaces-in-security-scheme-description (OPENAPI3DOCSGENSYNTAX_L840)
- no-trailing-leading-spaces-in-additional-header-description (OPENAPI3DOCSGENSYNTAX_L841)