OpenAPI 3.0 description of the API

[proshin-roman]

Hi folks,

it's definitely good to have a plain-text description of the API, but it certainly adds more problems when someone wants to generate a client for that API in some specific language. Based on my own experience, developing clients is not really worth it when the API changes often. Instead, having a standard OpenAPI description would solve a bunch of problems and will dramatically simplify creating clients (there are generators basically for any language https://openapi-generator.tech/docs/generators).

Do you have any plans on providing such a description? And would be your opinion on that topic?