SMS-Aktivierungs-API

Das gängige Klartext-Aktivierungsformat für Tools, die es bereits verwenden. Neue Integrationen können auch die REST-API nutzen.

Einführung in Verifizierungsnummern

Jeder Aufruf ist eine GET- (oder POST-) Anfrage an https://snsverify.com/stubs/handler_api.php mit Ihrem API-Schlüssel und einem Aktionsparameter. Der Schlüssel stammt von der API-Schlüssel-Seite Ihrer Konsole; bewahren Sie ihn privat auf, er kann Ihr Guthaben belasten. Antworten sind kurze Textzeilen wie ACCESS_NUMBER oder STATUS_OK oder JSON für die Listenaktionen, genau wie bei anderen Diensten, die dieses Format verwenden.

Dasselbe Konto, dieselben Regeln. Hier gekaufte Nummern verwenden dieselben Preise, dasselbe 20-Minuten-Fenster und dieselbe automatische Rückerstattung wie die Website. Dienstecodes sind die Kleinbuchstaben-Namen, die Sie auf unserer Seite sehen (whatsapp, telegram, google); Ländercodes sind ISO: us, gb, nl, de, af, al, dz, ao, ai, ar, am, aw, au, at, az, bs, bh, bd, bb, by, be, bz, bj, bt, bo, ba, bw, br, bn, bg, bi, kh, cm, ca, td, cl, cn, co, km, hr, cy, cz, dk, dj, dm, ec, eg, er, ee, sz, et, fj, fi, fr, ga, gm, ge, gh, gi, gr, gd, gp, gt, gn, gy, ht, hn, hk, hu, is, in, id, iq, ie, il, it, jm, jp, jo, kz, ke, kw, kg, la, lv, lb, ls, lr, lt, lu, mo, mg, mw, my, mv, ml, mt, mr, mu, mx, md, mc, mn, me, ms, ma, mz, na, np, nz, ni, ne, ng, no, om, pk, pa, py, pe, ph, pl, pt, qa, ro, rw, sn, rs, sc, sg, sk, si, so, za, es, sr, se, ch, tw, tj, tz, th, tg, tn, tr, tm, ug, ua, uy, uz, ve, vn, ye, zm, zw.

getBalance (GET) [+]

Ihr Guthaben in USD.

https://snsverify.com/stubs/handler_api.php?api_key=$KEY&action=getBalance

Antwort

ACCESS_BALANCE:12.50

getServicesList (GET) [+]

Dienstecodes, die Sie kaufen können (JSON).

https://snsverify.com/stubs/handler_api.php?api_key=$KEY&action=getServicesList

Antwort

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

getCountries (GET) [+]

Ländercodes (ISO, Kleinbuchstaben) und Vorwahlen (JSON).

https://snsverify.com/stubs/handler_api.php?api_key=$KEY&action=getCountries

Antwort

{"gb":{"name":"United Kingdom","dial":"44"}}

getPrices (GET) [+]

Preise in USD pro Land und Dienst. Beide Filter sind optional.

https://snsverify.com/stubs/handler_api.php?api_key=$KEY&action=getPrices&service=whatsapp&country=gb

Antwort

{"gb":{"whatsapp":{"cost":0.94,"count":100}}}

getNumber (GET) [+]

Kauft eine Nummer. Gibt die Aktivierungs-ID und die Nummer mit ihrer Landesvorwahl zurück.

https://snsverify.com/stubs/handler_api.php?api_key=$KEY&action=getNumber&service=whatsapp&country=gb

Antwort

ACCESS_NUMBER:AC-7K2M9QX4PB:447700900123

getStatus (GET) [+]

STATUS_WAIT_CODE (noch kein Code), STATUS_OK:<code>, STATUS_WAIT_RETRY:<letzter Code> (ein weiterer Code angefordert), STATUS_CANCEL (storniert oder erstattet).

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

Antwort

STATUS_OK:482915

setStatus (GET) [+]

status=1 bereit (ACCESS_READY), 3 weiterer Code (ACCESS_RETRY_GET), 6 beenden (ACCESS_ACTIVATION), 8 stornieren mit voller Rückerstattung, wenn kein Code angekommen ist (ACCESS_CANCEL).

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

Antwort

ACCESS_RETRY_GET

Typischer Ablauf

Rufen Sie getNumber mit Dienst und Land auf. Speichern Sie die Aktivierungs-ID und geben Sie die Nummer an die App weiter.
Rufen Sie setStatus mit status=1 auf, wenn die App die SMS gesendet hat (optional, markiert nur die Aktivierung als bereit).
Rufen Sie getStatus alle 3 bis 5 Sekunden ab, bis es mit STATUS_OK und dem Code antwortet.
Benötigen Sie einen weiteren Code? setStatus status=3, dann erneut abfragen, bis STATUS_OK den neuen Code anzeigt.
Fertig: setStatus status=6. Kein Code und Sie möchten Ihr Geld jetzt zurück? setStatus status=8 (nur bevor ein Code ankommt). Andernfalls erstattet sich die Aktivierung nach 20 Minuten selbst.

Fehlerantworten

BAD_KEY	Fehlender oder falscher API-Schlüssel.
BAD_ACTION	Unbekannte Aktion.
BAD_SERVICE	Unbekannter Dienstecode.
BAD_COUNTRY	Der Dienst wird in diesem Land nicht verkauft.
NO_BALANCE	Nicht genug Guthaben.
NO_NUMBERS	Derzeit keine Nummer verfügbar. Versuchen Sie es in Kürze erneut.
NO_ACTIVATION	Unbekannte Aktivierungs-ID oder nicht Ihre.
EARLY_CANCEL_DENIED	Ein Code ist bereits angekommen, daher kann die Aktivierung nicht storniert werden.
TOO_MANY_REQUESTS	Mehr als 300 Anfragen in einer Minute.
NO_ACTIVATIONS	Es sind bereits 20 Aktivierungen offen.

Grenzen: 300 Anfragen pro Minute pro Schlüssel, bis zu 20 offene Aktivierungen pro Konto. Preise Stand 2026-11-04