connexion icon indicating copy to clipboard operation
connexion copied to clipboard

OpenAPI Specification 3.1

Open danielbraun89 opened this issue 3 years ago • 9 comments

Description

Now that OpenApi version 3.1 has been officially released (along with the lucrative JsonSchema integration) is there any plan to support it in the near future?

danielbraun89 avatar Jul 09 '21 10:07 danielbraun89

I haven't checked it out, but this would be something which can be discussed as part of the Connexion 3.0 roadmap (#1395).

hjacobs avatar Jul 09 '21 11:07 hjacobs

I would say this one is blocked by https://github.com/swagger-api/swagger-ui/issues/5891 At least if the resulting API is meant to be documented using Swagger UI.

M-Reimer avatar Jul 10 '21 09:07 M-Reimer

It might also depend on https://github.com/Julian/jsonschema/issues/782 / https://github.com/Julian/jsonschema/pull/817, given the full alignment of OpenAPI 3.1.0 with JSON Schema draft 2020-12.

Ruwann avatar Jul 21 '21 20:07 Ruwann

There may also be required changes in https://github.com/p1c2u/openapi-spec-validator. For example https://github.com/p1c2u/openapi-spec-validator/pull/111 (which is based on a draft of OpenAPI spec 3.1).

tomghyselinck avatar Jul 29 '21 13:07 tomghyselinck

it seems like both mentioned dependencies were completed

pjungermann avatar Nov 27 '23 02:11 pjungermann

Yes, maybe also the bundled SwaggerUI needs to be updated to 5.x supporting OpenAPI 3.1.0

saper avatar Nov 27 '23 02:11 saper

Is it possible for the maintainers to explain their vision for support of OpenAPI 3.1?

chbndrhnns avatar Feb 05 '24 10:02 chbndrhnns

Do the maintainers know what changes would be necessary to support OpenAPI 3.1 and/or would be open to collaborating on making those changes?

el2857 avatar Mar 20 '24 15:03 el2857

I do not have a good view of what would be needed to support OpenAPI 3.1.

We have a Specification class which has an implementation for Swagger 2 and OpenAPI 3. A good starting point would be to provide an implementation for OpenAPI 3.1 and check if additional changes are needed.

This would be welcomed as a contribution.

RobbeSneyders avatar Mar 20 '24 16:03 RobbeSneyders