required-xml-name-in-response-content-schema
Overview
This rule belongs to the openapi-v3-apimatic-linting ruleset and states that:
In OpenAPI specifications, when using XML for the response content schema, the XML name is required to be specified. However, for array non-wrapped cases, the name does not need to be directly specified in the schema XML. In such cases, it will be present in the inner items schema.
| Property | Value |
|---|---|
| Enabled | Yes |
| Maximum Severity | Error |
| Message | XML name is required for response content schema. |
| Code | OPENAPI3APIMATIC_L842 |
| Type | Linting |
| Rule System | Semantic |
| Broad Category | OpenAPI XML |
| Products Impacted | API Transformer, Code Generation, Developer Experience Portal |
| Tags | openapi3 openapi apimatic semantic linting response content schema xml name |
Suggested Fixes
- Check the OpenAPI specification to confirm if any response content schema is missing an XML name.
- If any response content schema is missing an XML name, update the specification to include an XML name for the response content schema.