OpenAPIKit
OpenAPIKit copied to clipboard
OAS 3.2.0 XML features
Improvements for APIs using XML as a content format
- New
nodeTypefield allows mapping schemas to common XML node types: element, attribute, text, cdata, or none. -
attribute: trueis now deprecated in favor ofnodeType: attribute. -
wrapped: trueis now deprecated in favor ofnodeType: element(as nodeType defaults to none for arrays to preserve compatibility). - The xml keyword can be used in any Schema Object.
- XML namespaces can be IRIs (rather than URIs).
- Explanation and examples for many use cases including handling null, handling arrays, replacing the name, and handling ordered elements.
- Clarify that the root schema of an XML Object should use the component name.