How to convert OpenAPI 2.0 to OpenAPI 3.0? [closed]

by

Swagger Editor

Paste your OpenAPI 2.0 definition into https://editor.swagger.io and select Edit > Convert to OpenAPI 3 from the menu.

Swagger Editor conversion from OpenAPI 2.0 to OpenAPI 3.0

Swagger Converter

Converts OpenAPI 2.0 and Swagger 1.x definitions to OpenAPI 3.0.

https://converter.swagger.io/api/convert?url=OAS2_YAML_OR_JSON_URL

This gives you JSON. If you want YAML, send the request with the Accept: application/yaml header:

curl "https://converter.swagger.io/api/convert?url=OAS2_YAML_OR_JSON_URL" -H "Accept: application/yaml" -o ./openapi.yaml

API docs: https://converter.swagger.io

GitHub repo: https://github.com/swagger-api/swagger-converter

Swagger Codegen version 3.x

Can also convert OpenAPI 2.0 and Swagger 1.x definitions to OpenAPI 3.0. Swagger Codegen has a CLI version, Maven plugin, Docker images.

Here’s an example using the command-line version (you can download the latest JAR from Maven Central). Write the entire command on one line. Use openapi-yaml to get YAML or openapi to get JSON.

java -jar swagger-codegen-cli-3.0.19.jar generate
     -l openapi-yaml
     -i https://petstore.swagger.io/v2/swagger.yaml
     -o OUT_DIR

GitHub repo: https://github.com/swagger-api/swagger-codegen

More Related Contents:

  1. Swagger: How to have a property reference a model in OpenAPI 2.0 (i.e. nest the models)?
  2. How to specify if a field is optional or required in OpenAPI/Swagger?
  3. How to return an array of objects in SwaggerHub?
  4. How to document dynamic query parameter names in OpenAPI (Swagger)?
  5. How to define a mixed-type array (with different element types) in OpenAPI 2.0?
  6. How to define a property that can be string or null in OpenAPI (Swagger)?
  7. Swagger schema properties ignored when using $ref – why?
  8. How to define mutually exclusive query parameters in Swagger (OpenAPI)?
  9. Swagger 2.0: Multiple Path objects with different paths but same request and response
  10. Swagger/OpenAPI – use $ref to pass a reusable defined parameter
  11. Swagger: wildcard path parameters
  12. How to define an optional parameter in path using swagger
  13. Swagger: “equivalent path already exists” despite different parameters
  14. Re-using model with different required properties
  15. How to write OpenAPI 3 (Swagger) specification for property name in `map` object?
  16. How not to copy-paste 3 generic error responses in almost all paths?
  17. How to define global parameters in OpenAPI?
  18. Schema object without a type attribute in Swagger 2.0
  19. Swagger: take one or more values from enum
  20. How to export swagger.json (or yaml)
  21. Swagger/OpenAPI mock server
  22. How can I represent ‘Authorization: Bearer ‘ in a Swagger Spec (swagger.json)
  23. Swagger HashMap property type
  24. Swagger: map of
  25. Swagger complex response model with dynamic key value hash maps
  26. Post a json body with swagger
  27. Swagger API which is having query string
  28. How to add multiple example values for an array in OpenAPI/Swagger?
  29. Sending cookie session id with Swagger 3.0
  30. How to document default None/null in OpenAPI/Swagger using FastAPI?

Leave a Comment