Лимит запросов — максимальное число обращений к API за секунду или минуту для одного ключа; при превышении API возвращает 429 и Retry-After, а большие объёмы следует отправлять пакетными запросами.
Лимиты защищают платформу и учётные записи от неконтролируемых циклов. Для каждого ключа запросы считаются в скользящем окне, заголовки показывают предел и остаток, а ответ 429 сообщает, когда можно повторить попытку. Корректный клиент соблюдает Retry-After и для больших объёмов использует пакетные вызовы вместо множества параллельных одиночных запросов.
Лимит относится к запросам, а не к сообщениям: пакет из тысячи сообщений считается одним запросом.
В SMSMeteor: действует лимит 50 запросов в секунду на ключ; ответы содержат X-RateLimit-Limit, X-RateLimit-Remaining и Retry-After, а один пакет вмещает 1000 сообщений в одном запросе API.
Связанные термины
- Эндпоинт пакетной отправки
- Экспоненциальная задержка повторных запросов
- Пропускная способность (TPS)