Skip to content
New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

[REQ] Add support for OpenAPI 3.1 #10811

Closed
bilalshaikh42 opened this issue Nov 8, 2021 · 3 comments
Closed

[REQ] Add support for OpenAPI 3.1 #10811

bilalshaikh42 opened this issue Nov 8, 2021 · 3 comments

Comments

@bilalshaikh42
Copy link
Contributor

Is your feature request related to a problem? Please describe.

Unable to use code generation with OpenAPI version 3.1 specifications

Describe the solution you'd like

Add support for OASv 3.1

Describe alternatives you've considered

Currently, I am simply changing the version number included in the spec and disabling spec validation. This works just fine, since the only incompatible change that I am dealing with is the use of "examples" as a list instead of a single value. While the spec is invalid when doing this, it is still parsed and generates code just fine.

This approach would not work for some of the other changes, however.

Additional Context

Here are the major changes from the release announcement:

Major Changes in OpenAPI Specification 3.1.0

  • JSON Schema vocabularies alignment
  • New top-level element for describing Webhooks that are registered and managed out of band
  • Support for identifying API licenses using the standard SPDX identifier
  • PathItems object is now optional to make it simpler to create reusable libraries of components. Reusable PathItems can be described in the components object. There is also support for describing APIs secured using client certificates.
@thetric
Copy link

thetric commented Nov 8, 2021

Duplicate of #9083

This project website mistakenly states that it supports OpenAPI 3.x, although only 3.0 is supported:

Generate clients, servers, and documentation from OpenAPI 2.0/3.x documents

https://openapi-generator.tech/

@bilalshaikh42
Copy link
Contributor Author

bilalshaikh42 commented Nov 8, 2021 via email

@wing328 wing328 closed this as completed Nov 9, 2021
@antonio-petricca
Copy link
Contributor

Is it planned the support for 3.1?

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment
Projects
None yet
Development

No branches or pull requests

4 participants