-
-
Notifications
You must be signed in to change notification settings - Fork 1.1k
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
OpenAPI 3.0.0 #932
Comments
OpenAPI 3 would be real useful indeed, as it is often required. |
often required by whom? |
Well, by people who write requirements specifications :-D |
There are any progress in implementing of OpenAPI 3.0 specifications? |
OpenAPI 3.0 supports Bearer authentication in a way that v2 does not. It would be nice for Postgrest to generate (or support) v3 OpenAPI responses for those of us using Swagger-ui or similar tools. |
can it support now? |
Potential workaround for those interested is proxying postgREST root response and use something like https://github.com/Mermade/oas-kit/blob/main/packages/swagger2openapi/README.md to dynamically convert to v3 spec. On top of that it allows you to customize the oas document. |
This would be very useful, as it appears that ChatGPT requires OpenAPI 3.0 specs for its plugins and custom actions. |
+1 |
I found the official spec converter here: https://github.com/swagger-api/swagger-converter/blob/master/src/main/swagger/swagger.yaml It's provided as a docker container, so I'm going to go with the proxy approach as suggested by @tonyxiao |
FYI, there's work in progress for OpenAPI 3 on https://github.com/PostgREST/postgrest-openapi/ |
At the end of 2024 the OpenAPI v4 specification will also be released, not sure if this brings anything relevant to the table, but it might be a good idea to have at least v3.1 officially supported when the new major version comes out. |
Can't believe how slow this has been. Working on it now when v4 is near release |
How much have you contributed to it already? |
https://www.openapis.org/blog/2017/07/26/the-oai-announces-the-openapi-specification-3-0-0
https://blog.readme.io/an-example-filled-guide-to-swagger-3-2/
See also GetShopTV/swagger2#105
The text was updated successfully, but these errors were encountered: