SMSBulk
Справочник API

Создавайте с SMSBulk

Современный REST API и эндпоинты, совместимые с SMS-Activate. Начните за минуты.

Открыть справочник APIПолучить ключ API

Два стиля API

Выберите формат под ваш проект — оба работают на одной инфраструктуре.

Современный REST API

Чистый JSON API со спецификацией OpenAPI. Идеален для новых интеграций.

  • Тела запросов и ответов в JSON
  • Спецификация OpenAPI 3.0 на /api/docs
  • Авторизация Bearer token или x-api-key
  • Стандартные HTTP-коды статусов
curl https://smsbulk.net/api/v1/wallet/balance \
  -H "x-api-key: YOUR_KEY"

Совместимость со старым API

Совместим со стандартным отраслевым query-протоколом. Существующие бот-скрипты и библиотеки работают без изменений кода — просто направьте их на наш базовый URL.

  • Идентичный action-протокол
  • Plain text формат ответа
  • Совместимость с существующими бот-библиотеками
  • Каноническое сопоставление ID стран сохранено
curl "https://smsbulk.net/stubs/handler_api.php\
?api_key=YOUR_KEY&action=getBalance"
Гайд по миграции

Быстрый старт

От нуля до первого SMS — менее чем за 5 минут.

1

Получите ключ API

Создайте ключ API в панели. Каждый пользователь может создать до 10 ключей.

Открыть панель
2

Проверьте авторизацию

Убедитесь, что ключ работает, проверив баланс кошелька.

curl https://smsbulk.net/api/v1/wallet/balance \
  -H "x-api-key: YOUR_KEY"

# Response:
# { "balance": "10.00", "currency": "USD" }
3

Купите номер

Зарезервируйте виртуальный номер для SMS-верификации. Стоимость списывается с кошелька.

curl -X POST https://smsbulk.net/api/v1/activations \
  -H "x-api-key: YOUR_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "serviceCode": "wa",
    "countryIso": "TR"
  }'

# Response:
# {
#   "id": "cuid_xxx",
#   "phoneNumber": "905551234567",
#   "status": "WAITING",
#   "userCost": "0.50"
# }
4

Дождитесь SMS

Опрашивайте эндпоинт активации, пока статус не станет RECEIVED. Код SMS будет в ответе.

curl https://smsbulk.net/api/v1/activations/cuid_xxx \
  -H "x-api-key: YOUR_KEY"

# Response (when SMS arrives):
# {
#   "id": "cuid_xxx",
#   "smsCode": "123456",
#   "status": "RECEIVED",
#   ...
# }

Авторизация

Три способа передать ключ API.

Выберите метод под ваше окружение

1. Header (рекомендовано)

x-api-key: YOUR_API_KEY

Стандартная авторизация через заголовок. Работает и с REST, и с SMS-Activate эндпоинтами.

2. Bearer token

Authorization: Bearer YOUR_API_KEY

Совместимо с HTTP-клиентами, использующими Authorization по умолчанию.

3. Query string

?api_key=YOUR_API_KEY

Обязательно для эндпоинта совместимости /stubs/handler_api.php.

Храните ключи в секрете

Никогда не коммитьте ключи API в публичные репозитории и не выводите их в клиентском коде. У каждого ключа есть дневная квота — немедленно ротируйте при утечке.

Справочники

Гайд миграции старого API

Документация прямой совместимости для переноса существующих бот-интеграций. Список действий, ID стран, коды ошибок.

Ошибки и Rate Limits

Полный справочник кодов ошибок, политики rate limit, стратегии retry и руководство по idempotency.

Готовы к запуску?

Откройте интерактивный справочник и попробуйте каждый эндпоинт прямо в браузере.

Открыть справочник APIНачать