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

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

REST API для SMS

REST API для SMS позволяет программе отправлять сообщения и получать их статусы по HTTPS в формате JSON, используя стандартные методы и URL без постоянного соединения или специального телекоммуникационного протокола.

REST сводит работу с сообщениями к обычным веб-запросам. У ресурсов — сообщений, пакетов, тарифов — есть URL; HTTP-методы указывают, что с ними делать: POST создаёт, GET читает; тела передаются в JSON; а результат выражается HTTP-кодом состояния: 2xx — успех, 4xx — проблема с запросом, 5xx — проблема на сервере, причём в теле приходит машиночитаемый код ошибки. Каждый запрос самодостаточен и несёт собственные учётные данные, поэтому интегрироваться можно на любом языке с HTTP-клиентом — без специальной библиотеки, постоянного соединения и телекоммуникационного протокола вроде SMPP.

Отправка SMS через REST асинхронна по своей природе. Ответ на POST подтверждает, что сообщение принято, проверено и для него рассчитана цена; подтвердить доставку он не может — она происходит через секунды или часы в сети оператора. Статус приходит позже — через вебхук или при повторном чтении сообщения.

Качества, которые отличают хороший SMS API, проявляются при сбоях: ключи идемпотентности, благодаря которым повторы никогда не дублируют отправку, стабильные коды ошибок, подписанные вебхуки, заголовки лимитов запросов, тестовый режим и опубликованное описание OpenAPI.

Пример

Условный магазин отправляет POST-запрос с уведомлением о заказе: получатель в формате E.164, отправитель и текст. В ответе возвращаются идентификатор сообщения, статус queued, число сегментов, кодировка и цена. Через несколько мгновений вебхук сообщает статус sent, а вскоре после этого — delivered.

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

  • Считать ответ 2xx доказательством доставки.
  • Повторять POST-запрос после тайм-аута без ключа идемпотентности.
  • Ориентироваться на тексты ошибок, а не на их коды.
  • Вызывать API из браузера или мобильного приложения, раскрывая ключ.

В SMSMeteor: шесть эндпоинтов используют один базовый URL — https://api.smsmeteor.com/v1: POST /v1/messages отправляет одно сообщение, POST /v1/messages/batch — до 1 000, GET /v1/messages/{id} возвращает статус одного сообщения, GET /v1/messages выводит список сообщений с фильтрацией и курсорной пагинацией, GET /v1/rates возвращает публичную тарифную таблицу, а GET /v1/balance — баланс. Ключи — это bearer-ключи (sk_live_, sk_test_) с правами send, read или обоими. Ответы сообщают encoding и segments, а API никогда не переписывает текст. Описание OpenAPI 3.1 находится по адресу /docs/openapi.yaml; SMPP клиентам не предоставляется. Начните с быстрого старта.

Подробнее

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