Errors and limits

Rate Limits

The Pyrus API handles no more than 5,000 requests per 10 minutes per user.

Response HTTP headers contain additional information about limits:

• X-RateLimit-Limit — the maximum number of requests allowed in the current time interval.
• X-RateLimit-Remaining — the number of requests left in the current time interval.
• X-RateLimit-Reset — the number of seconds before the beginning of the next time interval.

If you exceed the limit access to the Pyrus API will be restricted. In this case, you will receive a response with HTTP Status Code 429: too_many_requests: You have reached the limit of requests per 10 minutes.

Other Limits

• The maximum allowed catalog items count — 15000.
• The maximum allowed catalog item length — 500.
• The maximum allowed number of task comments — 10000.
• The maximum allowed number of task attachments — 3000.
• The maximum allowed number of task steps — 20.

Possible Errors

API methods return errors in the JSON format. An example of an error might look like this:

{
     "error_code": "revoked_token",
     "error": "Authorization token has been revoked."
}

In addition to the error message, the response contains its code (which can be processed automatically). Error text descriptions may change, but their codes will be constant.

Below you can find error codes that can occur when working with the API.