required-api-declaration-apis

Overview

This rule belongs to the swagger-v1-validation ruleset and states that:

The root object of a Swagger v1 API Declaration document must list the APIs exposed on the current resource using the apis property.

Property	Value
Enabled	Yes
Maximum Severity	Error
Message	Required property apis in root object of API Declaration document is missing.
Code	SWAGGER1_V200
Type	Validation
Rule System	Semantic
Broad Category	API Declaration
Products Impacted	API Transformer, Code Generation, Developer Experience Portal
Tags	swagger1 swagger semantic validation apis api declaration

Suggested Fixes

• Add missing apis property in the root object i.e. in the top level properties of the document.
• Make sure that the apis property is a valid list and not set as null.

For More Information

• https://github.com/OAI/OpenAPI-Specification/blob/main/versions/1.2.md#52-api-declaration
• https://github.com/OAI/OpenAPI-Specification/blob/main/versions/1.2.md
• https://docs.apimatic.io/rulesets/overview/