wttr.in icon indicating copy to clipboard operation
wttr.in copied to clipboard

OpenAPI

Open Langmans opened this issue 6 months ago • 3 comments

Hello,

Are there any plans to have an openapi spec file available online somewhere, so that we can generate a client SDK using a tool such as swagger? That file describes the available methods + all what the requests and responses can be.

https://www.openapis.org/

example API: https://editor.swagger.io/

Langmans avatar May 14 '25 06:05 Langmans

Hi Langmas, yes, there are plans regarding OpenAPI compatibility. Is there something concrete you are thinking about, or do you just want to have some OpenAPI compatibility in general?

chubin avatar May 14 '25 08:05 chubin

No, nothing concrete. Just in general, or at least something that describes JSON REST methods.

It may be beneficial to define alternative URLs for the openAPI spec, the current URLs like .png?tqr0 or whatever are just handy for people that aren't developers. Having properly configured objects in the spec file makes it more readable.

Langmans avatar May 14 '25 10:05 Langmans

but actually, it will be only GET queries, right?

chubin avatar May 14 '25 10:05 chubin