Learn about the different error codes that the Smarter Drafter API can produce
Smarter Drafter uses HTTP response codes to show the status of an API request.
In general:
- Codes in the 200 range mean the request was successful.
- Codes in the 400 range mean the request failed with the information provided (e.g., a required parameter was not provided).
- Codes in the 500 range mean there's an error with Smarter Drafter's server (which is rare).
Some 4xx errors that could be handled programmatically (e.g., the data already exists) include an error code that briefly explains the error reported.
| Code | Response | Explanation |
|---|---|---|
| 200 | OK | Everything worked as expected. |
| 400 | Bad Request | The request was unacceptable, often due to missing a required parameter. |
| 401 | Unauthorised | No valid API key provided. |
| 402 | Request Failed | The parameters were valid but the request failed. |
| 403 | Forbidden | The API key doesn’t have permissions to perform the request. |
| 404 | Not Found | The requested resource doesn’t exist. |
| 409 | Conflict | The request conflicts with another request. |
| 429 | Too Many Requests | Too many requests hit the API too quickly. We recommend an exponential backoff of your requests. |
| 500, 502, 503, 504 | Server Error | Something went wrong on Smarter Drafter's end. (These are rare.) |