Квотирование

С целью обеспечения максимального уровня доступности сервиса, в Яндекс.Аудиториях предусмотрены ограничения на интенсивность запросов к API со стороны пользователей.

Одновременно действуют два вида таких ограничений:

  • по IP — определяет предельно допустимое количество запросов в секунду, пришедших с одного IP-адреса, и равно 30.
  • по user_login — ограничивает число запросов в сутки со стороны одного пользователя и равно 5000.

Интенсивность запросов рассчитывается отдельно для каждой из следующий групп методов API:

  • client_read — чтение параметров сегмента или учетной записи пользователя Яндекс.Аудиторий.
  • client_write — сохранение параметров сегмента или учетной записи пользователя Яндекс.Аудиторий.
  1. Превышение квот
  2. Ограничения на создание и изменение сегментов

Превышение квот

В случае превышения квот дальнейшие действия пользователя временно блокируются. При этом API возвращает ответ с HTTP-статусом 429 Too Many Requests. В теле ответа содержится информация о типе превышенной квоты.

При превышении квоты по IP разблокировка происходит, когда число запросов к API, совершенных за последнюю секунду, становится меньше 30.

При превышении квоты по user_login разблокировка происходит автоматически в полночь по московскому времени.

Ограничения на создание и изменение сегментов

При отправке запроса на создание или изменение сегмента любого типа действуют ограничения:

  • за минуту — не больше 10 запросов;
  • за час — не больше 100 запросов;
  • за сутки — не больше 500 запросов.

При отправке запроса на создание/изменение геосегментов действуют дополнительные ограничения: если на вашем логине 1000 или больше сегментов на основе данных о геолокации и меньше 5% из них используются для нацеливания в Директе или Дисплее, отправка запроса на создание геосегментов будет недоступна.

Примечание.

Ошибочные запросы учитываются в квотировании.