• 228 направлений
  • Без KYC — всегда
  • Bitcoin, Monero, USDT и ещё 4 валюты

API и интеграция

Эндпоинт пакетной отправки

Эндпоинт пакетной отправки принимает много сообщений одним запросом API и возвращает отдельный результат для каждого получателя, поэтому ошибка в одной строке не отменяет весь пакет.

Отправлять кампанию десятью тысячами одиночных запросов медленно, к тому же задолго до окончания вы упрётесь в лимит запросов. Пакетный эндпоинт принимает много сообщений за один вызов: вверху задаются общие значения по умолчанию — например, отправитель, метка кампании, расписание и темп, — а ниже идут сами сообщения, каждое со своим получателем, текстом и возможными переопределениями.

Проверка проходит на двух уровнях. Некорректный запрос — повреждённый JSON или отсутствующий список — отклоняется целиком, и в очередь ничего не ставится. Корректный запрос оценивается по каждому сообщению: допустимые сообщения принимаются и ставятся в очередь, а недопустимые — с неподдерживаемым префиксом или номером не в формате E.164 — возвращаются в том же списке отклонёнными, с указанием ошибки. Поэтому успешный статус запроса означает, что пакет обработан, а не что приняты все сообщения, и ответ нужно разбирать поэлементно. Если передать с пакетом ключ идемпотентности, повтор после тайм-аута не поставит пакет в очередь дважды.

Пример

Условная клиника отправляет три напоминания одним пакетом. Два номера корректны, а у третьего префикс, который не обслуживает ни один маршрут. В ответе — два принятых сообщения с идентификаторами и одно отклонённое с ошибкой. Клиника исправляет третий номер и отправляет его отдельно, а не повторяет весь пакет, что продублировало бы первые два.

Типичные ошибки

  • Понимать успешный ответ как «всё отправлено», не проверяя результаты по каждому сообщению.
  • Повторно отправлять весь пакет после частичного отклонения.
  • Помещать срочные коды в один пакет с медленной кампанией, отправляемой в заданном темпе.

В SMSMeteor: POST /v1/messages/batch принимает до 1 000 сообщений за запрос. Заданные на уровне пакета from, campaign, send_at, window и pace (per_minute или over_hours) применяются ко всем сообщениям, в которых они не переопределены. Некорректный запрос отклоняется целиком; недопустимые элементы возвращаются со статусом rejected и описанием ошибки и никогда не оплачиваются, а допустимые ставятся в очередь. Ответ содержит batch_id, accepted, rejected, total_price и messages[], а пакет считается одним запросом в рамках лимита. См. справочник по пакетной отправке и статью о том, как перечисляются отклонения.

Подробнее

Посмотрите, как это работает на практике.Для регистрации достаточно адреса электронной почты. Таблица тарифов открыта, оплата принимается в криптовалюте, тестовый ключ бесплатный.
Начать отправку