Check out the OpenAPI spec https://swagger.io/specification/ https://swagger.io/specification/. One advantage is that you can use the spec to generate both clie

Check out the OpenAPI spec https://swagger.io/specification/ https://swagger.io/specification/. One advantage is that you can use the spec to generate both client and server-side code, see https://deliveroo.engineering/2022/06/27/openapi-design-first.html https://deliveroo.engineering/2022/06/27/openapi-design-firs... for example. If you're looking for inspiration, there's a ton of OpenAPI links at https://apirank.dev/ https://apirank.dev/