Search code examples
spring-bootswaggeropenapi

OpenAPI vs swagger


What is the actual advantage of using OpenApi over swagger?

I am new to openApi technology, just wanted to know what more features are present in openApi than in swagger. The online documents didn't helped me. Can anyone help me.


Solution

  • OpenApi is essentially a further development of swagger, hence the version 3.0.0 instead of 1.0.0

    If you read the swagger blog Swagger was handed over to the OpenAPI Initiative, and all the swagger tools like editor.swagger.io support OpenAPI, and conversions between the two.

    as they write

    OpenAPI = Specification
    Swagger = Tools for implementing the specification

    (and swagger is also the term for the first two iterations of the spec)

    If you are not restricted by a specific version, I would recommend openapi, since the community is in theory bigger, and there has happened a lot since swagger v. 2.0.0, such as simplification and ease of use.

    more security schemes are supported, enhanced parameter types based on whether they are in the path, query, header or a cookie.

    Also there is an improvement in how you can define examples. I have participated in a project where we would have liked to use openapi instead of swagger for this reason, unfortunately, the API GW did not support it yet...