postgrest icon indicating copy to clipboard operation
postgrest copied to clipboard

OpenAPI 3.0.0

Open daurnimator opened this issue 8 years ago • 15 comments

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 https://github.com/GetShopTV/swagger2/issues/105

daurnimator avatar Aug 08 '17 04:08 daurnimator

OpenAPI 3 would be real useful indeed, as it is often required.

larsnaesbye avatar Dec 13 '18 23:12 larsnaesbye

often required by whom?

daurnimator avatar Dec 13 '18 23:12 daurnimator

Well, by people who write requirements specifications :-D

larsnaesbye avatar Dec 14 '18 00:12 larsnaesbye

There are any progress in implementing of OpenAPI 3.0 specifications?

kosmonaffft avatar Sep 03 '19 20:09 kosmonaffft

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.

kljensen avatar Aug 24 '20 20:08 kljensen

can it support now?

yasz avatar Dec 07 '22 04:12 yasz

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.

tonyxiao avatar Mar 01 '23 00:03 tonyxiao

This would be very useful, as it appears that ChatGPT requires OpenAPI 3.0 specs for its plugins and custom actions.

DaemonAlchemist avatar Nov 14 '23 04:11 DaemonAlchemist

This would be very useful, as it appears that ChatGPT requires OpenAPI 3.0 specs for its plugins and custom actions.

+1

Garett-MacGowan avatar Dec 12 '23 15:12 Garett-MacGowan

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

Garett-MacGowan avatar Dec 13 '23 15:12 Garett-MacGowan

FYI, there's work in progress for OpenAPI 3 on https://github.com/PostgREST/postgrest-openapi/

steve-chavez avatar Dec 13 '23 20:12 steve-chavez

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.

shania-g avatar Aug 09 '24 00:08 shania-g