Support for OpenAPI 3.2 XML definitions

[visma-dinei-rockenbach]

OpenAPI 3.2.0 was released on Sep 19, with improvements on how to describe XML structures (new nodeType field). This new version now allows OpenAPI specs to represent XML elements with attributes, for example (see issue #630 in OpenAPI Spec repository).

I am currently experimenting different developer hubs to decide which one we should use for our product, and according to my experience, currently GitBook is one of the best developer hubs for documenting XML-based APIs. However, supporting the new OpenAPI 3.2 XML definition is a must for us, as GitBook is currently unable to correctly render our XML based on an OpenAPI spec. So, I am opening this feature request for you to implement support to this new OpenAPI specification.

[nolannbiron]

Thanks for the detailed context!
We’re already working on supporting OpenAPI 3.2, including the improvements around XML structures.

We’ll share an update once it’s fully supported in GitBook 🙂

[visma-dinei-rockenbach]

Hello Nolann, thanks for the quick answer. Do you have any estimate of when this would be available?

We are currently discussing if we should buy or build our developer portal and the timeline is important.