search

PostgREST / postgrest

REST API for any Postgres database
https://postgrest.org
MIT License
23.48k stars 1.03k forks source link

OpenAPI 3.0.0 #932

Open daurnimator opened 7 years ago

daurnimator commented 7 years ago

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

larsnaesbye commented 5 years ago

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

daurnimator commented 5 years ago

often required by whom?

larsnaesbye commented 5 years ago

Well, by people who write requirements specifications :-D

kosmonaffft commented 5 years ago

There are any progress in implementing of OpenAPI 3.0 specifications?

kljensen commented 4 years ago

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.

yasz commented 1 year ago

can it support now?

tonyxiao commented 1 year ago

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.

DaemonAlchemist commented 1 year ago

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

Garett-MacGowan commented 11 months ago

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

+1

Garett-MacGowan commented 11 months ago

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

steve-chavez commented 11 months ago

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

shania-g commented 3 months ago

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.

tjmcdonough commented 2 months ago

Can't believe how slow this has been. Working on it now when v4 is near release

wolfgangwalther commented 2 months ago

Can't believe how slow this has been.

How much have you contributed to it already?