OpenAPIKit icon indicating copy to clipboard operation
OpenAPIKit copied to clipboard

OAS 3.2.0 XML features

Open mattpolzin opened this issue 6 months ago • 0 comments

Improvements for APIs using XML as a content format

  • New nodeType field allows mapping schemas to common XML node types: element, attribute, text, cdata, or none.
  • attribute: true is now deprecated in favor of nodeType: attribute.
  • wrapped: true is now deprecated in favor of nodeType: 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.

mattpolzin avatar Oct 27 '25 01:10 mattpolzin