Ограничения

Обновлено: 05.02.2024

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

Интеграционное API ограничивает число запросов, поступающих от одного пользователя.

Одновременно работают три ограничения:

1. Максимум 100 запросов за 10 сек.
2. Максимум 1 000 запросов за 10 мин.
3. Максимум 3 000 запросов за 1 час.

В случае превышения квоты сервер вернет ответ:

429 too many requests

Для Reporting API установлены следующие ограничения на количество запросов:

1. Максимум 10 запросов за 10 сек.
2. Максимум 100 запросов за 10 мин.
3. Максимум 200 запросов за 1 час.

Ограничение на размер страницы данныхОграничение на размер страницы данных

Запросы данных ограничены 500 сущностями (возвращаемыми объектами).

Используйте ключи запросов $skip и $top для постраничной загрузки данных. При этом важно использовать сортировку, например по id, иначе сервер может возвращать повторяющиеся элементы на разных «страницах».

Если ответ на запрос достигает максимального размера страницы, OData включает свойство nextLink с URL запроса для получения следующей страницы.

Ограничение на нагрузкуОграничение на нагрузку

Важно! Для каждого абонента доступна ограниченная мощность вычислительных ресурсов. Избыточное использование API может приводить к деградации производительности для рядовых пользователей вашей организации. В таком случае система телеметрии и мониторинга может автоматически ограничить доступность API для конкретного IP адреса.

Хорошая практикаХорошая практика

1. Не воспринимайте API как локальную БД или сервис с неограниченным ресурсами.
2. Продумывайте архитектуру интеграции. Помните, что почти у всех сущностей есть свойства created и modified, есть фильтрация данных, есть возможности для серверной группировки.
3. Интеграционное API в целом не предназначено для выгрузки из системы больших объемов данных. Для этого лучше подходит Reporting API.