Ограничения

Обновлено: 01.06.2023

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

Интеграционное 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.