There are quite a few "API language" specifications, the most popular ones being API Blueprint and Swagger/OpenAPI.
Perhaps the best thing about using any of those tools is having a nice standard for writing and designing our API endpoints, with several tools built around them (i.e. Dredd for testing).
Downside might be a bit of extra work at the beginning.
Opinions are welcome.
There are quite a few "API language" specifications, the most popular ones being API Blueprint and Swagger/OpenAPI.
Perhaps the best thing about using any of those tools is having a nice standard for writing and designing our API endpoints, with several tools built around them (i.e. Dredd for testing).
Downside might be a bit of extra work at the beginning.
Opinions are welcome.