Improve API documentation
As an API developer I need to understand the error codes and details of the API so that I can integrate and handle errors thrown by the API elegantly.
The gaps are most notably:
* HTTP status codes explanation
* lack of standardized error codes (example: https://docs.aws.amazon.com/AmazonS3/latest/API/ErrorResponses.html)
* very little or no explanation (example: https://api.aiven.io/doc/#tag/Service/operation/ListProjectServiceTypes)
9
votes
AdminIvan Radulovic
(Senior Specialist Solution Architect, Aiven.io)
shared this idea
-
I have a customer calling this API:
https://api.aiven.io/v1/account/*******/authenticationGetting the following without any details on the actual error:
HTTP/1.1 500 Internal Server Error
{"message":"Internal Server Error"}
