Please add OpenAPI 3.1 supports

[andrejs-sinkevics]

Please add OpenAPI 3.1 supports
OpenAPI Specification

[bnasslahsen]

@andrejs-sinkevics,

springdoc-openapi is buit on top of the swagger-core library.
There is an ongoing request about the support of OpenaAPI 3.1.

Once this is done, the support will be updated in the springdoc-openapi.

[linarkou]

Hey, v2.2.0 of swagger-core with OAS 3.1.0 support was released! Looking forward to updates 🙂

[bnasslahsen]

@linarkou,

The initial support for OAS 3.1.0 is now added.
To use this support, you need to declare the following property:

springdoc.api-docs.version=openapi_3_1

Note that the swagger-ui support is not yet available.
We will wait for this ticket to be completed.

[okohub]

@bnasslahsen Do we need to wait extra things to have "requestBody" in GET-HEAD-DELETE?

[bnasslahsen]

@okohub,

Please stop writing same messages in many tickets...
As answered in #1003, You need a version of OpenAPI that supports that which is not the case.

The recommendation is the avoid this kind of representation and we will stick on that:
In other cases where the HTTP spec is vague (such as GET, HEAD and DELETE), requestBody is permitted but does not have well-defined semantics and SHOULD be avoided if possible.

The extra thing, is that you can use OpenApiCustomiser that can help you achieve this goal.