Прочее

Публичный API SMS4You: REST API для приёма SMS, OTP и виртуальных номеров

01.07.2026
Публичный API SMS4You: REST API для приёма SMS, OTP и виртуальных номеров

Встречайте публичный API SMS4You: автоматизируйте приём SMS и работу с номерами

Мы рады объявить о запуске того, чего многие из вас давно ждали, - публичного API SMS4You. Теперь всё, что вы делали в личном кабинете руками, можно делать программно: покупать номера, получать коды из SMS и e-mail, следить за балансом и ценами. Ваши скрипты, боты и системы регистрации могут работать с SMS4You напрямую, без единого клика.

Ниже рассказываем, что именно мы выпустили, зачем это нужно и как начать за пять минут.

Коротко о главном

  • Полноценный REST API для OTP-активаций (приём SMS) и e-mail-активаций.
  • Каталог стран, сервисов и актуальных цен - всё, что видно в кабинете, доступно и через API.
  • Вебхуки: коды и смены статуса прилетают на ваш сервер сами, без постоянного опроса.
  • Совместимость с протоколом SMS-Activate: переносите готовые интеграции, поменяв один адрес.
  • Простая аутентификация по токену, который вы создаёте сами в личном кабинете.
  • Интерактивная документация с возможностью пробовать запросы прямо в браузере.

Зачем нужен API

Ручная покупка номеров хороша, когда активаций немного. Но как только речь заходит о десятках и сотнях регистраций, массовых прогонах или встраивании приёма SMS в собственный продукт, кликать в интерфейсе становится неудобно. API решает именно эту задачу: вы описываете логику один раз в коде, а дальше всё происходит автоматически, в любом объёме и в любое время суток.

Типичные сценарии, ради которых мы это сделали:

  • автоматическая регистрация и верификация аккаунтов в вашем софте;
  • массовые прогоны и тестирование, где нужно много номеров подряд;
  • встраивание приёма SMS-кодов прямо в ваш сервис или продукт;
  • перенос существующих интеграций, написанных под других провайдеров.

Что умеет API

1. Активации под ключ: от покупки номера до получения кода

Весь жизненный цикл активации доступен через понятные REST-эндпоинты:

  • выбрать сервис и страну, посмотреть доступность и цену;
  • купить номер одним запросом;
  • забрать пришедшую SMS (или письмо, если это e-mail-активация);
  • завершить, отменить или запросить повторную SMS - управление статусом полностью в ваших руках.

Поддерживаются оба ключевых продукта: приём SMS (OTP) и e-mail-активации. Каждая активация имеет уникальный идентификатор, по которому вы обращаетесь к ней в дальнейшем.

2. Актуальный каталог и цены

API отдаёт живые данные:

  • список стран с телефонными кодами;
  • список сервисов (для SMS и для e-mail);
  • цены по конкретному сервису или стране, а также полный прайс-лист с постраничной выдачей.

Важная деталь: цены возвращаются с учётом вашей персональной скидки. То, что вы видите в ответе API, - это ровно то, что спишется с баланса.

3. Вебхуки: коды приходят к вам сами

Постоянно опрашивать сервер в ожидании SMS - расточительно и медленно. Поэтому у SMS4You есть вебхуки: как только приходит новое сообщение или меняется статус активации, мы сами отправляем HTTP-запрос на указанные вами адреса.

  • вы получаете события мгновенно, без polling;
  • каждый вызов подписан HMAC-подписью, так что вы можете убедиться, что запрос действительно от нас;
  • реализованы повторные попытки доставки, если ваш сервер на секунду оказался недоступен;
  • для тех, кто закрывает приём трафика по whitelist, мы публикуем список IP-адресов, с которых уходят вебхуки.

Вместе с REST API это закрывает интеграцию целиком: запросы вы отправляете сами, а обновления получаете push-каналом.

4. Совместимость с SMS-Activate: миграция без переписывания

Отдельно то, чем мы особенно гордимся. Если у вас уже есть софт, написанный под API SMS-Activate, вам не нужно переписывать интеграцию. SMS4You поддерживает совместимый протокол: достаточно поменять адрес сервера на наш и подставить свой ключ.

Ваш существующий код, библиотеки и боты продолжат работать как есть, но уже с номерами, ценами и качеством SMS4You. Это делает переход на нас вопросом одной строчки в конфиге, а не недели разработки.

5. Безопасная и простая аутентификация

Никаких логинов и паролей в скриптах. Вы заходите в личный кабинет, во вкладке API-токены создаёте персональный токен и используете его в запросах. Токен можно передать тремя способами - выбирайте, что удобнее вашей библиотеке:

  • заголовком Authorization: Bearer <токен>;
  • заголовком X-Api-Token: <токен>;
  • query-параметром ?api_token=<токен>.

Токенов можно завести несколько (например, отдельный на каждый проект) и в любой момент отозвать скомпрометированный, не затрагивая остальные. Значение токена показывается один раз при создании - дальше оно хранится только у вас.

6. Документация, в которой всё можно потрогать

Мы подготовили интерактивную документацию на базе OpenAPI: каждый эндпоинт описан, у каждого поля указан тип, а запросы можно выполнять прямо со страницы, не открывая терминал. Там же лежит отдельный раздел про вебхуки и совместимый с SMS-Activate протокол.

Документация доступна по адресу docs.sms4you.org.

Быстрый старт за пять минут

Базовый адрес API: https://api.sms4you.org/api/v1

Шаг 1. Проверяем баланс и скидку аккаунта

curl https://api.sms4you.org/api/v1/me \
  -H "Authorization: Bearer ВАШ_ТОКЕН"

{
  "data": {
    "name": "Ivan",
    "email": "[email protected]",
    "email_verified": true,
    "balance": "12.3456",
    "currency": "USD",
    "discount_percent": 5
  }
}

Шаг 2. Смотрим цену на нужный сервис

curl "https://api.sms4you.org/api/v1/prices?service_id=SERVICE_ID" \
  -H "Authorization: Bearer ВАШ_ТОКЕН"

Шаг 3. Покупаем номер

curl -X POST https://api.sms4you.org/api/v1/activations \
  -H "Authorization: Bearer ВАШ_ТОКЕН" \
  -H "Content-Type: application/json" \
  -d '{"service_id": 123, "country_id": 7, "price": "0.20"}'

В ответе придёт номер телефона и идентификатор активации.

Шаг 4. Забираем пришедшую SMS

curl https://api.sms4you.org/api/v1/activations/АКТИВАЦИЯ_ID/messages \
  -H "Authorization: Bearer ВАШ_ТОКЕН"

А если вы настроите вебхук, этот шаг вообще не понадобится - код прилетит к вам сам.

Лимиты и надёжность

  • Запросы ограничены по частоте (по умолчанию до 120 запросов в минуту), чтобы сервис оставался стабильным для всех.
  • Все ответы приходят в едином формате, включая ошибки: понятный код, человекочитаемое сообщение и, при необходимости, детали. Обрабатывать их в коде - одно удовольствие.
  • Для покупок требуется подтверждённый e-mail на аккаунте - обычная мера безопасности.

Для кого это

  • Разработчикам, которым нужен приём SMS внутри своего продукта.
  • Арбитражу и маркетингу, где регистрации идут потоком.
  • QA-командам, тестирующим сценарии с телефонной верификацией.
  • Всем, кто уже пользуется SMS-Activate-совместимым софтом и хочет провайдера без боли миграции.

Что дальше

Публичный API - это фундамент, на котором мы будем строить дальше. В планах - расширять покрытие продуктов и возможностей, прислушиваясь к вашим запросам. Если вам не хватает какого-то эндпоинта или сценария, напишите нам через чат поддержки: мы читаем всё и приоритизируем то, что реально нужно.

Попробовать прямо сейчас:

  1. Зайдите в личный кабинет и создайте токен во вкладке API-токены.
  2. Откройте документацию на docs.sms4you.org.
  3. Сделайте первый запрос - и автоматизируйте всё остальное.

Приятной интеграции, и пусть коды приходят вовремя.