Get hands-on experience with 20+ free Google Cloud products and $300 in free credit for new customers.

Swagger 2.0 Vs OAS3.x (Open API Specification)

We understand that OAS 3.x being latest to Swagger 2.0 specification.

OAS 3.0 lists following changes

1.Structural improvements

2.Request Parameters

3.Protocol and Payload

4.Documentation

5.Security

& few other outlined information in terms of differences like

OAS 3.0 offers support for describing callbacks, which can be used to define asynchronous APIs or Webhooks, Extended JSON Schema support & Some security definition changes

But from a business Use case prospective do we opt for OAS 3.x ? we see more from structural changes from Swagger 2.0 to OAS3.X.

Like one of case will be more readability/interactivity to documentation with respect to Example value for response is a valid Business case.

Let us know your inputs in terms of use case based on your experience or usage ?

0 2 1,326
2 REPLIES 2