Ограничения

Обновлено: 09.05.2024

Лимиты частоты запросов (Rate Limiting)Лимиты частоты запросов (Rate Limiting)

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

Действуют следующие лимиты:

• не более 100 запросов за 10 секунд;
• не более 1 000 запросов за 10 минут;
• не более 3 000 запросов за 1 час.

При превышении лимита сервер возвращает ошибку:

429 Too Many Requests

Лимиты для Reporting APIЛимиты для Reporting API

Для Reporting API установлены отдельные ограничения:

• не более 10 запросов за 10 секунд;
• не более 100 запросов за 10 минут;
• не более 200 запросов за 1 час.

Лимит на размер страницы данныхЛимит на размер страницы данных

Один запрос возвращает не более 500 сущностей (объектов).

Для постраничной загрузки данных используйте параметры запроса $skip и $top. Чтобы избежать повторов на разных страницах, обязательно применяйте сортировку (например, по id).

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

Ограничение на вычислительную нагрузкуОграничение на вычислительную нагрузку

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

Рекомендации по использованиюРекомендации по использованию

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