Anmelden

API für SMS-Verifizierung

Nummernkauf, Codeabfrage und Stornierung mit einer einzigen HTTP-Anfrage. Im branchenüblichen handler_api-Format verbinden Sie Registrierungs-Software und Bots nur mit Adresse und Schlüssel.

API-Schlüssel erhalten

Erstellen Sie nach dem Login im Menü API des Kontobereichs einen Schlüssel. Der Schlüssel wird nur einmal bei der Erstellung angezeigt, speichern Sie ihn also sofort. Die API nutzt dasselbe Guthaben und dieselben Preise wie die Website.

Standardadresse

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

Wichtige Anfragen

actionAufgabeBeispielantwort
getBalanceGuthaben prüfenACCESS_BALANCE:12.50
getPrices&service=telegram&country=gbPreise und verfügbare Nummern nach Dienst und Land{"gb":{"telegram":{"cost":0.207,"count":8877728}}}
getNumber&service=telegram&country=gbNummer kaufenACCESS_NUMBER:ID:PHONE
getStatus&id=IDCode prüfenSTATUS_WAIT_CODE / STATUS_OK:CODE
setStatus&id=ID&status=8Nummer stornieren (vor dem Code, volle Erstattung)ACCESS_CANCEL
setStatus&id=ID&status=3Weiteren Code an dieselbe Nummer empfangenACCESS_RETRY_GET
setStatus&id=ID&status=6Nutzung beendenACCESS_ACTIVATION

Anfrageparameter

NameErforderlichBeschreibung
api_keyAlleIm Kontobereich erstellter API-Schlüssel
actionAllegetBalance, getPrices, getNumber, getStatus, setStatus
servicegetNumberDienstcode (z. B. telegram, whatsapp, google). Entspricht der Adresse der Dienstseite
countrygetNumberZweistelliger Ländercode (z. B. gb, us, id)
idgetStatus, setStatusVon getNumber zurückgegebene Nummern-ID (beginnt mit N-)
statussetStatus8 Stornieren, 3 Weiteren Code, 6 Abschließen, 1 Bereit

Antwortcodes und Bedeutung

AntwortBedeutungGeld
ACCESS_NUMBER:ID:PHONENummer erhaltenNummernpreis wird abgebucht
STATUS_WAIT_CODEWarte auf den CodeUnverändert
STATUS_OK:CODEDer Code ist daZahlung abgeschlossen
STATUS_WAIT_RETRY:CODEWarte auf den nächsten Code (vorheriger Code wird mit angezeigt)Ohne Aufpreis
STATUS_CANCELStorniert oder Zeit abgelaufenOhne Code erstattet
ACCESS_CANCELStorniertVolle Erstattung
ACCESS_RETRY_GETAuf einen weiteren Code an dieselbe Nummer wartenOhne Aufpreis
ACCESS_ACTIVATIONNutzung der Nummer abgeschlossenUnverändert
NO_BALANCESofort nach dem Aufladen verfügbarKeine Abbuchung
NO_NUMBERSFür dieses Land ist gerade keine Nummer verfügbarKeine Abbuchung
NO_ACTIVATIONSSie haben 20 offene NummernKeine Abbuchung
EARLY_CANCEL_DENIEDBei Nummern mit Code statt Stornieren abschließen (6)Unverändert
BAD_KEYDer API-Schlüssel ist ungültigKeine Abbuchung
BAD_SERVICE / BAD_COUNTRYDienst- oder Ländercode ist ungültigKeine Abbuchung
NO_ACTIVATIONNummern-ID nicht gefundenUnverändert
TOO_MANY_REQUESTSLimit von 300 Anfragen pro Minute überschrittenKeine Abbuchung

Beispiele nach Sprache

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)

So funktioniert es

  • Holen Sie mit getNumber eine Nummer, geben Sie sie im Anmeldeformular ein und rufen Sie dann alle 5 Sekunden getStatus auf.
  • Bei STATUS_OK:Code geben Sie den Code ein und schließen mit setStatus 6 ab.
  • Kommt innerhalb von 20 Minuten kein Code, wird der Nummernpreis automatisch Ihrem Guthaben erstattet.
  • Bis zu 300 Anfragen pro Minute.