Downconverting OpenAPI 3.0.x to 2.0

LucyBot-Inc / api-spec-converter

Convert API descriptions between popular formats such as OpenAPI(fka Swagger), RAML, API Blueprint, WADL, etc.

https://lucybot-inc.github.io/api-spec-converter/

MIT License

1.11k stars 180 forks source link

Downconverting OpenAPI 3.0.x to 2.0 #140

Closed MikeRalphson closed 6 years ago

MikeRalphson commented 6 years ago

There's a MIT-licensed converter here.

It's designed as an Angular module, but it looks easy to shim if necessary
It may be a little simplistic / incomplete in terms of producing valid OpenAPI 2.0 output

MikeRalphson commented 6 years ago

A more complete option (when available - it doesn't currently have this mode) would be to use the Mulesoft converter to round-trip through RAML 1.0

MikeRalphson commented 6 years ago

The first option works better than I expected (i.e. the output given a Petstore in 3.0 is valid 2.0). If anyone wants to pick this up, an example of the shim code is here https://gist.github.com/MikeRalphson/a14643b0731699516d9f8743ac59e643

rbren commented 6 years ago

Here's a first pass: https://github.com/LucyBot-Inc/api-spec-converter/pull/141

I went the other route and just edited the Angular code you found above to make it more friendly. We wouldn't be able to pull in new changes, but it seems a bit safer.