HTTP Status Codes
The Ocrolus API leverages a specific set of HTTP status codes to indicate the success or failure of an incoming request.
All requests that are successfully sent to our API return the HTTP status code 200 OK
.
To diagnose requests that are experiencing server issues (a rare occurrence), use the following HTTP status codes:
HTTP status code | Cause |
---|---|
502 Bad Gateway | The Ocrolus public proxy is experiencing issues. |
503 Service Unavailable | The service is down for maintenance. |
504 Gateway Timeout | The service did not respond within a reasonable time. |
429 Too Many Requests | You've made too many API requests recently. Our API rate limit is five per second, with up to 25 extra requests buffered and processed at that rate. If this buffer is full, further requests will fail with this status code. |
413 Payload Too Large | You're attempting to upload a file that's too large. See here for more information about what you can do. |
Application error codes
If processing a request generates an application error, the JSON response includes the error. For more information, see Ocrolus Status Codes.
Updated 2 months ago