API

API для SMS-активации

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

Создайте API-ключ на странице ключей в консоли. Он показывается только один раз.

Получить API-ключ Регистрация

Базовый адрес и ключ

Отправляйте GET или POST запросы на базовый адрес с параметрами api_key и action. Создайте ключ на странице API ключа в консоли; он показывается только один раз.

https://snsactivate.com/stubs/handler_api.php?api_key=YOUR_KEY&action=getBalance

Коды сервисов, это названия на наших страницах (например, whatsapp, telegram, google). Коды стран, ISO коды в нижнем регистре (us, gb, in). Лимит: 300 запросов в минуту на ключ. Каждая активация имеет окно в 20 минут, как и в консоли.

getBalance

Ваш баланс в USD.

GET https://snsactivate.com/stubs/handler_api.php?api_key=KEY&action=getBalance

ACCESS_BALANCE:12.50

getServicesList

Доступные сервисы для покупки (JSON).

GET https://snsactivate.com/stubs/handler_api.php?api_key=KEY&action=getServicesList

{"status":"success","services":[{"code":"whatsapp","name":"WhatsApp"}]}

getCountries

Коды стран (ISO, нижний регистр) и телефонные коды (JSON).

GET https://snsactivate.com/stubs/handler_api.php?api_key=KEY&action=getCountries

{"us":{"name":"United States","dial":"1"}}

getPrices

Цены в USD и количество номеров в наличии по странам и сервисам. Оба фильтра необязательны.

GET https://snsactivate.com/stubs/handler_api.php?api_key=KEY&action=getPrices&service=whatsapp&country=us

{"us":{"whatsapp":{"cost":0.18,"count":130598}}}

getNumber

Покупает активацию. Возвращает ID активации и номер с кодом страны.

GET https://snsactivate.com/stubs/handler_api.php?api_key=KEY&action=getNumber&service=whatsapp&country=us

ACCESS_NUMBER:AC-7K2M9QX4PB:13475550182

getStatus

STATUS_WAIT_CODE (код ещё не пришёл), STATUS_OK:<code>, STATUS_WAIT_RETRY:<последний код> (запрошен ещё один код), STATUS_CANCEL (отменено или возвращено).

GET https://snsactivate.com/stubs/handler_api.php?api_key=KEY&action=getStatus&id=AC-7K2M9QX4PB

STATUS_OK:482913

setStatus

status=1 готово (ACCESS_READY), 3 ещё один код (ACCESS_RETRY_GET), 6 завершено (ACCESS_ACTIVATION), 8 отмена с полным возвратом, если код не пришёл (ACCESS_CANCEL).

GET https://snsactivate.com/stubs/handler_api.php?api_key=KEY&action=setStatus&id=AC-7K2M9QX4PB&status=3

ACCESS_RETRY_GET

Типовой процесс

Вызовите getNumber с сервисом и страной. Сохраните ID.
Введите номер в приложение и запросите SMS.
Вызывайте getStatus каждые 5-10 секунд до STATUS_OK.
Нужно ещё SMS? setStatus 3, затем снова getStatus. Готово: setStatus 6.
Нет кода? setStatus 8 отменяет с полным возвратом. Без вызова возврат произойдёт автоматически по истечении окна.

Ошибки

BAD_KEY	Отсутствует или неверный API ключ.
BAD_ACTION	Неизвестное действие.
BAD_SERVICE	Неизвестный код сервиса.
BAD_COUNTRY	Сервис не продаётся в этой стране.
NO_BALANCE	Недостаточно средств.
NO_NUMBERS	Сейчас нет доступных номеров. Попробуйте позже.
NO_ACTIVATION	Неизвестный ID активации или не принадлежит вам.
EARLY_CANCEL_DENIED	Код уже пришёл, поэтому активацию нельзя отменить.
TOO_MANY_REQUESTS	Более 300 запросов в минуту.
NO_ACTIVATIONS	Уже открыто 20 активаций.