Zaloguj

API weryfikacji SMS

Zakup numeru, sprawdzanie kodu i anulowanie jednym zapytaniem HTTP. To popularny w branży format handler_api, więc programy do rejestracji i boty połączysz, podając tylko adres i klucz.

Pobierz klucz API

Po zalogowaniu utwórz klucz w menu API na ekranie konta. Klucz jest pokazywany tylko raz przy tworzeniu, więc od razu go zapisz. API korzysta z tego samego salda i cen co strona.

Adres podstawowy

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

Główne zapytania

actionZadaniePrzykład odpowiedzi
getBalanceSprawdź saldoACCESS_BALANCE:12.50
getPrices&service=telegram&country=gbCeny i dostępne numery według usług i krajów{"gb":{"telegram":{"cost":0.207,"count":8877728}}}
getNumber&service=telegram&country=gbZakup numeruACCESS_NUMBER:ID:PHONE
getStatus&id=IDSprawdź kodSTATUS_WAIT_CODE / STATUS_OK:CODE
setStatus&id=ID&status=8Anuluj numer (przed kodem, pełny zwrot)ACCESS_CANCEL
setStatus&id=ID&status=3Odbierz kolejny kod na ten sam numerACCESS_RETRY_GET
setStatus&id=ID&status=6ZakończACCESS_ACTIVATION

Pola zapytania

NazwaWymaganeOpis
api_keyWszystkieKlucz API utworzony na ekranie konta
actionWszystkiegetBalance, getPrices, getNumber, getStatus, setStatus
servicegetNumberKod usługi (np. telegram, whatsapp, google). Taki sam jak w adresie strony listy usług
countrygetNumberDwuliterowy kod kraju (np. gb, us, id)
idgetStatus, setStatusID numeru zwrócone przez getNumber (zaczyna się od N-)
statussetStatus8 anuluj, 3 kolejny kod, 6 zakończ, 1 gotowe

Treść odpowiedzi i znaczenie

OdpowiedźZnaczeniePieniądze
ACCESS_NUMBER:ID:PHONENumer otrzymanyCena numeru zostaje pobrana
STATUS_WAIT_CODECzekamy na kodBez zmian
STATUS_OK:CODEKod dotarłPłatność zakończona
STATUS_WAIT_RETRY:CODECzekamy na kolejny kod (z poprzednimi kodami)Bez dodatkowych opłat
STATUS_CANCELAnulowano lub czas minąłZwrócono, jeśli nie było kodu
ACCESS_CANCELAnulowanoPełny zwrot
ACCESS_RETRY_GETCzekaj na kolejny kod na ten sam numerBez dodatkowych opłat
ACCESS_ACTIVATIONZakończyłeś korzystanie z numeruBez zmian
NO_BALANCEDoładuj saldo i odbieraj od razuBez potrącenia
NO_NUMBERSNumer z tego kraju jest teraz niedostępnyBez potrącenia
NO_ACTIVATIONSMasz 20 otwartych numerówBez potrącenia
EARLY_CANCEL_DENIEDNumer z kodem zakończ (6) zamiast anulowaćBez zmian
BAD_KEYNieprawidłowy klucz APIBez potrącenia
BAD_SERVICE / BAD_COUNTRYNieprawidłowy kod usługi lub krajuBez potrącenia
NO_ACTIVATIONNie znaleziono ID numeruBez zmian
TOO_MANY_REQUESTSPrzekroczono 300 zapytań na minutęBez potrącenia

Przykłady w różnych językach

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)

Jak to działa

  • Pobierz numer przez getNumber, wpisz go na ekranie rejestracji i wywołuj getStatus co 5 sekund.
  • STATUS_OK:kod, gdy kod przyjdzie, wpisz go i zakończ przez setStatus 6.
  • Jeśli kod nie przyjdzie w ciągu 20 minut, cena numeru automatycznie wraca na saldo.
  • Do 300 zapytań na minutę.