The only way to generate OpenApi 3.0 from RapidML specs seems to be a two stage process of
Thanks for the suggestion. This one is on the roadmap!
In general, OpenAPI 3.0 support is the primary goal we are focused on now, including code generation, Normalizer and mock service. An OpenAPI v3 version of the RAPID-XChange GenTemplates will follow.
Oh, that's awesome! Thank you.
I'd be nice to have a documentation describing difference between those two gentemplates. I presume that XChange is either the newest one or the one that is meant for automatic post-processing, but I have never seen any confirmation or documentation on that.
Right, it looks like "RAPID-XChange" is a brand name we pulled out of thin air.
In fact it is a specification that formalizes a mapping from RAPID-ML, which is an abstract model of the API, to a concrete wire format that can be described in OpenAPI 2.0 or 3.0 using one of two modes: "Contract" (RXC) or "DTO" (RXDTO).
The RAPID-XChange specification document is internal, pending finalization.
The RXC GenTemplate is complete, and is currently the only supported RAPID-ML --> OpenAPI conversion path.
The RXDTO GenTemplate is currently labeled as "RAPID-XChange Interop," and is not completely implemented.
And the differences between RAPID-XChange Contract and RAPID-XChange DTO still need to be documented properly.
I think you can expect all of this to be completed and clarified with the RAPID-XChange v3 GenTemplates.