News API - HTTP Statuses
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
|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.|
|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 firstname.lastname@example.org.|