Ограничения

Технические ограничения

Перечисленные ограничения являются постоянными для всех клиентов.

• один пользователь может иметь только один ключ API (у одной компании может быть несколько пользователей);
• не более 100 подключений в секунду с одного IP-адреса;
• в одном запросе POST /api/message нельзя создать больше 300 000 сообщений;
• URL запросов не должны содержать / в конце.

Настраиваемые ограничения

Перечисленные настройки находятся в личном кабинете.

Белый список IP-адресов

Вы можете указать список разрешённых IP-адресов в разделе «Настройки / HTTP API».

Запросы, отправляемые с других IP, будут получать ответ 401 Unauthorized.

Не создавать сообщения при недостаточном количестве средств

Данная опция настраивается в разделе «Настройки / Ограничения».

При включенной опции запрос на создание сообщения получит ошибку с кодом 420, если на балансе недостаточно средств для отправки сообщения.

Если опция отключена, то запрос получит код ответа 200, сообщение будет создано, но получит статус no_money и не будет отправлено.

Ограничения по странам

В разделе «Настройки / Ограничения» вы можете выбрать страны, в которые разрешена отправка сообщений.

При попытке отправить сообщение в страну не из выбранного списка, сообщение получит статус route_closed.

Лимит на дубликаты

В разделе «Настройки / Ограничения» вы можете указать временной интервал, в течение которого сообщения на один и тот же номер будут считаться дубликатами.

При отправке повторного запроса на создание сообщения в течение указанного интервала, запрос получит ошибку с кодом 400.

Эта опция также влияет на отложенные сообщения. Например, если сообщение было создано заранее с кодом ответа 200, оно может оказать дубликатом из-за других запросов. В этом случае сообщение получит статус doubled.

Общие лимиты

Перечисленные ограничения настраиваются в разделе «Настройки / Ограничения».

Запросы, которые выполняются после исчерпания одного из лимитов, будут получать ответ с кодом 400. В случае, если сообщение всё-таки было создано, оно получит статус limit_exceeded и не будет отправлено.

Параметр	Описание
Лимит расходов на месяц	Сумма в рублях, которая может быть потрачена на отправку в течение календарного месяца
Общий лимит на сутки	Максимальное количество сообщений, которое может быть отправлено в течение суток
Лимит на уникальный номер	Максимальное количество сообщений, которое может быть отправлено на уникальный номер телефона в течение суток
Лимит на уникальный номер и текст	Максимальное количество сообщений с одинаковым текстом, которое может быть отправлено на уникальный номер телефона в течение суток