Category: Software, Business, Database, Data, yaml
by GraphQL already did this at its inception by coming up with a whole specification that describes how APIs of its type should behave.
It’s a language agnostic way to describe a RESTful API, that can be used to generate code-stubs and documentation.
They can be used to generate automatically: OpenAPI is used and backed by many large companies.
The OpenAPI Initiative is part of the Linux Foundation, which makes it more trustworthy and likely to remain supported.