Лимиты и оптимизация API


На использование API установлены следующие лимиты:

GET Для GET-запросов действует ограничение сервера в 8 кБ. Если запрос превышает этот размер, будет возвращена ошибка 414 Request-URL Too Large.

POST В POST-запросах данные передаются через Body, поэтому ограничение на длину URL не актуально. Однако существуют внутренние лимиты системы на длину названия задачи, команды, описания и других полей. Для описания лимит составляет 65 кБ (65536 символов). Если описание превышает этот объём, лишняя часть будет просто обрезана - при этом система не вернет ошибку.

Частота запросов. Не более 1 запроса в секунду. При превышении возвращается ошибка Too many requests.

Количество записей в ответе. Лимит составляет 10 000 записей. Например, если в аккаунте более 10 000 задач, то запрос, который пытается получить все задачи аккаунта, вернёт ошибку "Too many tasks (10000 max)".

Рекомендации:
  • Используйте вебхуки вместо частого опроса (polling), где это возможно - это значительно снижает количество запросов.
  • Чтобы не превышать лимиты API и уменьшить нагрузку на систему, избегайте большого количества одиночных запросов для получения каждого элемента отдельно. Используйте групповую выдачу с нужными фильтрами - это сокращает число обращений, ускоряет обработку данных и повышает стабильность интеграции.
  • Если особенности вашей бизнес-логики требуют большого количества запросов, пожалуйста, обратитесь к нам через форму поддержки

    Мы рассмотрим ваш кейс и постараемся помочь - например, добавив дополнительные параметры к запросам, чтобы уменьшить их количество.