Увійти

API для SMS-верифікації

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

Отримати ключ API

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

Основна адреса

https://nuviosms.com/stubs/handler_api.php?api_key=API_KEY&action=...

Основні запити

actionЩо робимоПриклад відповіді
getBalanceПеревірити балансACCESS_BALANCE:12.50
getPrices&service=telegram&country=gbЦіни і доступні номери за сервісами та країнами{"gb":{"telegram":{"cost":0.207,"count":8877728}}}
getNumber&service=telegram&country=gbКупівля номераACCESS_NUMBER:ID:PHONE
getStatus&id=IDПеревірити кодSTATUS_WAIT_CODE / STATUS_OK:CODE
setStatus&id=ID&status=8Скасування номера (до надходження коду, повне повернення)ACCESS_CANCEL
setStatus&id=ID&status=3Отримати ще один код на той самий номерACCESS_RETRY_GET
setStatus&id=ID&status=6ЗавершитиACCESS_ACTIVATION

Параметри запиту

Ім'яОбов'язковоОпис
api_keyУсіКлюч API, створений на екрані акаунта
actionУсіgetBalance, getPrices, getNumber, getStatus, setStatus
servicegetNumberКод сервісу (наприклад: telegram, whatsapp, google). Збігається з адресою сторінки у списку сервісів
countrygetNumberДвобуквений код країни (наприклад: gb, us, id)
idgetStatus, setStatusID номера, повернений getNumber (починається з N-)
statussetStatus8 скасувати, 3 ще один код, 6 завершити, 1 готово

Текст відповіді і значення

ВідповідьЗначенняГроші
ACCESS_NUMBER:ID:PHONEНомер отриманоВартість номера списується
STATUS_WAIT_CODEОчікуємо кодБез змін
STATUS_OK:CODEКод надійшовОплату завершено
STATUS_WAIT_RETRY:CODEЧекаємо наступний код (разом із попереднім)Без доплат
STATUS_CANCELСкасовано або час вийшовЯкщо коду не було, кошти повернуто
ACCESS_CANCELСкасованоПовне повернення
ACCESS_RETRY_GETЧекаємо ще один код на той самий номерБез доплат
ACCESS_ACTIVATIONВикористання номера завершеноБез змін
NO_BALANCEПоповніть баланс і отримуйте одразуНе списується
NO_NUMBERSЗараз номер цієї країни недоступнийНе списується
NO_ACTIVATIONSАктивних номерів: 20Не списується
EARLY_CANCEL_DENIEDДля номера з отриманим кодом не скасування, а завершення (6)Без змін
BAD_KEYКлюч API не збігаєтьсяНе списується
BAD_SERVICE / BAD_COUNTRYКод сервісу або країни не збігаєтьсяНе списується
NO_ACTIVATIONID номера не знайденоБез змін
TOO_MANY_REQUESTSПеревищено ліміт 300 запитів за хвилинуНе списується

Приклади різними мовами

import time, requests

BASE = "https://nuviosms.com/stubs/handler_api.php"
KEY = "API_KEY"

def call(**p):
    return requests.get(BASE, params={"api_key": KEY, **p}, timeout=30).text

r = call(action="getNumber", service="telegram", country="gb")
if not r.startswith("ACCESS_NUMBER"):
    raise SystemExit(r)
_, num_id, phone = r.split(":")
print("Number:", phone)

for _ in range(240):                      # 20 minutes
    s = call(action="getStatus", id=num_id)
    if s.startswith("STATUS_OK"):
        print("Code:", s.split(":")[1])
        call(action="setStatus", id=num_id, status=6)
        break
    time.sleep(5)

Як користуватися

  • Отримайте номер через getNumber, введіть його на екрані реєстрації, а потім викликайте getStatus кожні 5 секунд.
  • STATUS_OK:код. Коли код надійде, введіть його і завершіть через setStatus 6.
  • Якщо код не надійде протягом 20 хвилин, вартість номера автоматично повернеться на баланс.
  • До 300 запитів за хвилину.