API

SMS активація API

Купуйте номери та читайте коди зі своїх скриптів. API використовує загальний формат SMS активації, тому більшість існуючих клієнтів працюють шляхом зміни базової адреси та ключа.

Створіть свій API ключ на сторінці 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

Купує активацію. Повертає ідентифікатор активації та номер телефону з кодом країни.

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 з вказаним сервісом та країною. Збережіть ідентифікатор.
Введіть номер у додатку та запросіть 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	Невідомий ідентифікатор активації або він не належить вам.
EARLY_CANCEL_DENIED	Код вже надійшов, тому активацію не можна скасувати.
TOO_MANY_REQUESTS	Більше 300 запитів за хвилину.
NO_ACTIVATIONS	Вже відкрито 20 активацій.