SMSREC
ВходПополнить баланс
REST API v1

Автоматизируйте SMS-активации

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

Получить API-ключhttps://smsrec.com/api/v1

Авторизация

Создайте или обновите ключ в настройках аккаунта и передавайте его в заголовке Authorization. Полный ключ показывается один раз; SMSREC хранит только его криптографический хеш.

Authorization: Bearer smsrec_live_YOUR_API_KEY
Храните ключ на сервере. Никогда не добавляйте его в код браузерного или мобильного приложения.

Ошибки, лимиты и идемпотентность

Ответы возвращаются в JSON и содержат поле ok. Текущий лимит — 60 запросов в минуту на один API-ключ. Для покупки нужен уникальный Idempotency-Key, чтобы повтор запроса из-за сбоя сети не купил второй номер.

{ "ok": false, "error": {"code": "insufficient_balance", "message": "Not enough balance."} }

GET/api/v1/balance

Возвращает текущий баланс аккаунта.

curl https://smsrec.com/api/v1/balance \ -H "Authorization: Bearer $SMSREC_API_KEY"

GET/api/v1/services

Возвращает все сервисы с доступными номерами и их минимальной актуальной ценой.

GET/api/v1/prices?service=telegram

Возвращает до 500 актуальных предложений по сервисам и странам. Укажите service, country или оба параметра.

POST/api/v1/activations

service обязательно — код сервиса из endpoint services
country обязательно — код страны из endpoint prices
Idempotency-Key обязательный заголовок — уникальное значение для этой попытки покупки
curl -X POST https://smsrec.com/api/v1/activations \ -H "Authorization: Bearer $SMSREC_API_KEY" \ -H "Idempotency-Key: order-2026-0001" \ -H "Content-Type: application/json" \ -d '{"service":"telegram","country":"indonesia"}'

GET/api/v1/activations/{id}

Проверяйте статус каждые 3–5 секунд. После получения SMS статус изменится на received, а поле code будет содержать код подтверждения.

{ "ok": true, "activation": { "id": 42, "phone": "+628123456789", "status": "received", "code": "482913", "price_usd": "0.68" } }

POST/api/v1/activations/{id}/cancel

Отменяет ожидающую активацию и возвращает её стоимость на баланс SMSREC. Полученная активация завершается без возврата.

curl -X POST https://smsrec.com/api/v1/activations/42/cancel \ -H "Authorization: Bearer $SMSREC_API_KEY"