OAS 3.2: XML

[philsturgeon]

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.