Ошибки и ограничения

Ограничение количества запросов

К методам Pyrus API можно обращаться не чаще 5000 раз в 10 минут для каждого пользователя.

В HTTP-заголовках ответа содержится дополнительная информация по ограничениям:

• X-RateLimit-Limit — максимальное количество запросов, разрешенное в данном временном интервале;
• X-RateLimit-Remaining — количество запросов до превышения ограничения в данном временном интервале;
• X-RateLimit-Reset — количество секунд до начала следующего временного интервала.

После превышения лимита доступ к Pyrus API будет ограничен. В таком случае вы получите ответ с кодом состояния 429:

{
     "error_code": "too_many_requests",
     "error": "You have reached the limit of requests per 10 minutes."
}

Другие ограничения

• Максимально допустимое количество элементов справочника — 15000.
• Максимально допустимая длина элемента справочника — 500.
• Максимально допустимое количество комментариев к задаче — 10000.
• Максимально допустимое количество приложенных к задаче файлов — 3000.
• Максимально допустимое количество приложенных к комментарию файлов — 100.
• Максимально допустимое количество этапов в задаче — 20.
• Максимальное количество задач, получаемых в одном запросе списка задач по форме, — 20000.

Возможные ошибки

Все методы API возвращают ошибки в формате JSON. Пример ошибки может выглядеть так:

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

Кроме текста ошибки, ответ содержит её код, который можно обрабатывать автоматически. Тексты ошибок могут меняться, но их коды останутся неизменными.

Ниже приведены коды ошибок, которые могут возникать при работе с API.