supported-response-message-code
Overview
This rule belongs to the swagger-v1-validation
ruleset and states that:
If multiple responses are disabled via import settings provided in the APIMatic Metadata file, only response definitions in Operation Object responseMessages
belonging to status code ranges 200-208 and 400-599 will be imported. Those outside the supported range will be ignored automatically during import/transformations in APIMatic.
Property | Value |
---|---|
Enabled | Yes |
Maximum Severity | Warning |
Message | Provided response status code is not supported in the current import configuration. |
Code | SWAGGER1_V700 |
Type | Validation |
Rule System | Semantic |
Broad Category | Response Messages |
Products Impacted | API Transformer, Code Generation, Developer Experience Portal |
Tags | swagger1 swagger semantic validation http status code status code http response responses |
Suggested Fixes
- Enable import setting
ImportMultipleResponses
using the APIMatic Metadata file. - Remove the response definition from the
responseMessages
list that uses the unsupported statuscode
.
For More Information
- https://github.com/OAI/OpenAPI-Specification/blob/main/versions/1.2.md#525-response-message-object
- https://docs.apimatic.io/manage-apis/create-or-import-api/#import-settings-object
- https://docs.apimatic.io/changelog/support-for-multiple-responses-added-in-api-transformer-across-all-formats
- https://github.com/OAI/OpenAPI-Specification/blob/main/versions/1.2.md
- https://docs.apimatic.io/rulesets/overview/