Request Errors
Routific uses conventional HTTP response codes to indicate the success or failure of an API request. In general: Codes in the 2xx range indicate success. Codes in the 4xx range indicate an error based on the information provided in the request (for example a required parameter missing from the request). Codes in the 5xx range indicate an error with Routific's servers, these tend to be rare creatures — do let us know if you found one!
Some 4xx errors can be handled programmatically based on the error type and message returned in the body of the response.
| HTTP Status Code | Description |
|---|---|
| 200 - OK | Everything worked as expected. |
| 400 - Bad Request | The request validation failed, most likely due to a missing mandatory parameter |
| 401 - Unauthorized | API key is either invalid or missing from the request |
| 403 - Forbidden | API key doesn't have the required permissions to perform the request |
| 404 - Not Found | Requested endpoint or resource doesn't exist |
| 50X - Server Errors | Something went wrong inside Routific's servers |