Convert OpenAPI 3.0 to Swagger 2.0

openapi openapi-generator mashery

Is there a generator to convert OpenAPI 3.0 to Swagger 2.0?

Mashery, an API gateway, requires Swagger 2.0 format on input to open endpoint.


Solution 1:

  • LucyBot api-spec-converter (online version, GitHub repo, Node.js module) can convert from OpenAPI 3.0 to 2.0.

  • API Transformer also claims to be able to convert OpenAPI 3.0 back to OpenAPI 2.0. There's a command-line version too.

Keep in mind that OAS3→OAS2 convertion is lossy in general, because OAS3 has features that did not exist in OAS2 (such as multiple servers, oneOf/anyOf, different schemas per media type, objects in query string parameters, cookie parameters, and others).

Solution 2:

I needed version 2.0 for Power Automate.

When you are building some Azure Functions, try to create them in Visual Studio and enable any checkbox that is named Swagger not OpenAPI.

Now the API of your Azure Function contains the swagger.json that you can set into Power Automate Custom Connector.

Related

Set local environment variables in C++
How do I execute a .scm script (outside of the REPL) with MIT-Scheme?
filtering a list using LINQ
C++11 static_assert and template instantiation
RetentionPolicy CLASS vs. RUNTIME
Prove : Let A be a set. Then there is a set B such that B /∈ A.
Are Fourier series a basis for $L^2((-\pi,\pi)^m)$?
Is there a quadratically closed field strictly between the quadratic closures of $\mathbb{Q}$ and $\mathbb{Q}(\sqrt[3]{2})$?
Part of the third Isomorphism theorem for modules
Inequality. $ab^2+bc^2+ca^2 \geq a+b+c.$
Why does $f(-x+a)$ shift to the right?
Shortest path in conformal maps of a surface