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
ImportMultipleResponsesusing the APIMatic Metadata file. - Remove the response definition from the
responseMessageslist 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/