search

swagger-api / swagger-core

Examples and server integrations for generating the Swagger API Specification, which enables easy access to your REST API
http://swagger.io
Apache License 2.0
7.37k stars 2.17k forks source link

Swagger, OpenAPI and YAML version details #3579

Open saagarsonawane opened 4 years ago

saagarsonawane commented 4 years ago

Hello Team,

I am looking for details around swagger versions which supports YAML version 1.1, 1.2 etc. and OpenAPI specs versions 2.0, 3.0 etc. Could someone please help with these details?

example : Swagger 2.X supports -> OpenAPI 3.0, YAML ??

Hhow could one update YAML version say 1.2 to 1.1.

I am using swagger-maven-plugin and above struggling to find/update above information to generate right API specifications.

Thanks, Sagar

frantuma commented 4 years ago

If you're referring to swagger-core support, version 2.x (branch v1) supports Swagger/OpenAPI 2.0 and YAML 1.1 (in terms of deserializing and serializing); version 3.x (branch master) supports OpenAPI 3.0 and YAML 1.1; updating version 3.x/master to support YAML 1.2 is in the roadmap.

Please close ticket if this answers your question

saagarsonawane commented 4 years ago

I am facing issue with date and double quotation mark. With the details provided here https://github.com/wework/speccy/pull/368 I thought to use YAML 1.1 to solve my issue.

I want to comply OpenAPI 3.0, could you suggest any solution around same.

frantuma commented 4 years ago

It's not really clear what issue are you trying to solve specifically related to swagger-core. It would help if you could add a test case and detailed description of actual vs expected behaviour