Appearance
Response Codes
Wombat 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 that failed given the information provided (e.g., passing data that is invalid or of the wrong shape, etc.). Codes in the 5xx range indicate an internal error, we monitor and fix these as they arise (they should be rare).
Responses
| http code | status | |
|---|---|---|
2xx | Ok | Things went as expected. |
400 | Bad Request | The request was rejected, most likely because of invalid data / parameters being passed in. |
401 | Unauthorized | Token / Key Expiry or Basic Authentication is invalid. |
403 | Forbidden | Not enough permissions, not targeting the right client / organization, etc. |
404 | Not Found | The requested resource doesn’t exist. |
429 | Too Many Requests | Too many requests hit the API too quickly. We recommend an exponential backoff of your requests. |
5xx | Server Error | Woopsie, our bad. |