Общие сведения
Надежность и безопасность
Начало работы
Общие концепции
Учёт времени
Управление проектами
Компоненты
Управление ресурсами
Управление финансами
Управление затратами
Управление биллингом
Управление задачами
Компоненты
Концепции
Инструкции
Аналитика
Типы отчётов
Использование отчётов
Группировка и суммирование данных источника
Группировка данных в отчете
Типы виджетов
Общие отчёты и шаблоны
Настройка отчёта
Пользовательские настройки отчёта
Вычисляемые поля
Выражения вычисляемых полей
Использование панелей мониторинга
Публикация панелей
Фильтры источников данных
API
Настройка и администрирование
Типовой порядок настройки системы
On-premises
История изменений
FAQ

Ограничения

Обновлено: 09.05.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.

Содержание

Ограничение на число запросов Ограничение на размер страницы данных Ограничение на нагрузку Хорошая практика
Ничего не найдено

Перейти на русскую версию?