SMS Rooms — Virtual Numbers for SMS Verification

API Документация

ГлавнаяAPI

Поддерживаются POST и GET запросы.

Запросы должны иметь ключ API в качестве параметра api_key

Адрес для API запросов: https://sms-rooms.com/stubs/handler_api.php

Получение номера

Запрос:

https://sms-rooms.com/stubs/handler_api.php?api_key=$api_key&action=getNumber&service=$service&country=$country&ref=$ref&maxPrice=$maxPrice

Параметры:

$api_keyВаш API ключ
$serviceСервис для заказа
$countryСтрана номера
$refID аккаунта(необязательно)
$maxPriceМаксимальная цена(необязательно)

Ответ:

ACCESS_NUMBER:$activationId:$phoneNumber

Пример реального запроса:

https://sms-rooms.com/stubs/handler_api.php?api_key=YOUR_API_KEY&action=getNumber&service=tg&country=187&maxPrice=5

Ответ::

ACCESS_NUMBER:2887:17744056708

Ошибки:

BAD_KEY - неверный API-ключ
BAD_ACTION - некорректное действие
BAD_SERVICE - некорректное наименование сервиса
BAD_COUNTRY - некорректное наименование страны
NO_BALANCE - недостаточно средств на балансе
NO_NUMBERS - нет доступных номеров

Проверка статуса активации

Запрос:

https://sms-rooms.com/stubs/handler_api.php?api_key=$api_key&action=getStatus&id=$id

Параметры:

$api_keyВаш API ключ
$idID активации полученный в getNumber

Ответ:

STATUS_OK:'Код из смс' или STATUS_WAIT_CODE

Ошибки:

BAD_KEY - неверный API-ключ
BAD_ACTION - некорректное действие
NO_ACTIVATION - ID активации не существует

Проверка баланса

Запрос:

https://sms-rooms.com/stubs/handler_api.php?api_key=$api_key&action=getBalance

Параметры:

$api_keyВаш ключ API

Ответ:

ACCESS_BALANCE:'Баланс аккаунта'

Ошибки:

BAD_KEY - неверный API-ключ
BAD_ACTION - некорректное действие

Изменение статуса активации

Запрос:

https://sms-rooms.com/stubs/handler_api.php?api_key=$api_key&action=setStatus&status=$status&id=$id

Параметры:

$api_keyВаш ключ API
$idID активации
$statusСтатус: 1-готовность, 3-запросить еще, 6-завершить, 8-отменить

Ответ:

ACCESS_READY / ACCESS_ACTIVATION / ACCESS_CANCEL / ACCESS_RETRY_GET

Пример реального запроса:

https://sms-rooms.com/stubs/handler_api.php?api_key=YOUR_API_KEY&action=setStatus&status=3&id=2887

Ответ::

ACCESS_RETRY_GET

Ошибки:

BAD_KEY - неверный API-ключ
BAD_ACTION - некорректное действие
NO_ACTIVATION - ID активации не существует
BAD_STATUS - некорректный статус

Список сервисов

Запрос:

https://sms-rooms.com/stubs/handler_api.php?api_key=$api_key&action=getServicesList

Параметры:

$api_keyВаш API ключ

Ответ:

{"code": "ID сервиса", "name": "Название сервиса"}

Ошибки:

BAD_KEY - неверный API-ключ
BAD_ACTION - некорректное действие

Список стран

Запрос:

https://sms-rooms.com/stubs/handler_api.php?api_key=$api_key&action=getCountries

Параметры:

$api_keyВаш API ключ

Ответ:

{"id": "ID страны", "rus": "Название на русском", "eng": "Название на английском"}

Ошибки:

BAD_KEY - неверный API-ключ
BAD_ACTION - некорректное действие

Список количества номеров

Запрос:

https://sms-rooms.com/stubs/handler_api.php?api_key=$api_key&action=getNumbersStatus&country=$country

Параметры:

$api_keyВаш API ключ
$countryСтрана номера

Ответ:

{"код_сервиса": "количество_номеров"}

Ошибки:

BAD_KEY - неверный API-ключ
BAD_ACTION - некорректное действие
BAD_COUNTRY - некорректное наименование страны

Список цен

Запрос:

https://sms-rooms.com/stubs/handler_api.php?api_key=$api_key&action=getPrices&service=$service&country=$country

Параметры:

$api_keyВаш API ключ
$serviceСервис для заказа(необязательно)
$countryСтрана номера(необязательно)

Ответ:

{"Код страны": {"Код сервиса": {"Цена": Количество}}}

Ошибки:

BAD_KEY - неверный API-ключ
BAD_ACTION - некорректное действие
BAD_COUNTRY - некорректное наименование страны
BAD_SERVICE - некорректное наименование сервиса