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

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

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

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

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

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

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

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

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

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

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

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

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

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