Along with the HTTP methods that the API responds to, it will also return standard HTTP statuses, including error codes.
In the event of a problem, the status will contain the error code, while the body of the response will usually contain additional information about the problem that was encountered.
In general, if the status returned is in the 200 range, it indicates that the request was fulfilled successfully and that no error was encountered.
Return codes in the 400 range typically indicate that there was an issue with the request that was sent. Among other things, this could mean that you did not authenticate correctly, that you are requesting an action that you do not have authorization for, that the object you are requesting does not exist, or that your request is malformed.
If you receive a status in the 500 range, this generally indicates a server-side problem. This means that we are having an issue on our end and cannot fulfill your request currently.
Error Codes & Responses
|400||Bad Request||The server cannot or will not process the request due to an apparent client error.|
|401||Unauthorized||Authentication credentials were missing or incorrect.|
|404||Not Found||The URI requested is invalid or the resource requested, such as a story, does not exists.|
|405||Method Not Allowed||A request method is not supported for the requested resource.|
|414||URI Too Long||The URI provided was too long for the server to process. The maximum Request URI size is 8 kB and body can't be larger than 8 MB.|
|422||Unprocessable Entity||The request was invalid or cannot be otherwise served.|
|429||Too Many Requests||Usage limits are exceeded.|
|500||Internal Server Error||An unexpected error has occurred and engineers have been informed. If you continue to have problems, contact email@example.com.|
|503||Service Unavailable||The server is currently unavailable (because it is overloaded or down for maintenance).|