API per Attivazione SMS

Il comune formato di attivazione in testo semplice, per strumenti che lo utilizzano già. Le nuove integrazioni possono anche utilizzare l'API REST.

Introduzione ai Numeri di Verifica

Ogni chiamata è una richiesta GET (o POST) a https://snsverify.com/stubs/handler_api.php con la tua chiave API e un parametro action. La chiave proviene dalla pagina della chiave API nel tuo console; tienila privata, può spendere il tuo credito. Le risposte sono brevi righe di testo come ACCESS_NUMBER o STATUS_OK, o JSON per le azioni di elenco, esattamente come altri servizi che usano questo formato.

Stesso account, stesse regole. I numeri acquistati qui utilizzano gli stessi prezzi, la stessa finestra di 20 minuti e lo stesso rimborso automatico del sito web. I codici servizio sono i nomi in minuscolo che vedi sul nostro sito (whatsapp, telegram, google); i codici paese sono 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) [+]

Il tuo credito in USD.

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

Risposta

ACCESS_BALANCE:12.50

getServicesList (GET) [+]

Codici servizio che puoi acquistare (JSON).

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

Risposta

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

getCountries (GET) [+]

Codici paese (ISO, minuscolo) e prefissi telefonici (JSON).

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

Risposta

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

getPrices (GET) [+]

Prezzi in USD per paese e servizio. Entrambi i filtri sono opzionali.

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

Risposta

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

getNumber (GET) [+]

Acquista un numero. Restituisce l'id di attivazione e il numero con il suo prefisso paese.

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

Risposta

ACCESS_NUMBER:AC-7K2M9QX4PB:447700900123

getStatus (GET) [+]

STATUS_WAIT_CODE (nessun codice ancora), STATUS_OK:<code>, STATUS_WAIT_RETRY:<ultimo codice> (richiesto un altro codice), STATUS_CANCEL (annullato o rimborsato).

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

Risposta

STATUS_OK:482915

setStatus (GET) [+]

status=1 pronto (ACCESS_READY), 3 altro codice (ACCESS_RETRY_GET), 6 fine (ACCESS_ACTIVATION), 8 annulla con rimborso completo se non è arrivato alcun codice (ACCESS_CANCEL).

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

Risposta

ACCESS_RETRY_GET

Flusso Tipico

Chiama getNumber con servizio e paese. Salva l'id di attivazione e dai il numero all'app.
Chiama setStatus con status=1 quando l'app ha inviato l'SMS (opzionale, segna solo l'attivazione come pronta).
Interroga getStatus ogni 3-5 secondi finché non risponde con STATUS_OK e il codice.
Hai bisogno di un altro codice? setStatus status=3, poi interroga di nuovo finché STATUS_OK mostra il nuovo codice.
Fatto: setStatus status=6. Nessun codice e vuoi indietro i soldi ora: setStatus status=8 (solo prima che arrivi un codice). Altrimenti l'attivazione si rimborsa automaticamente dopo 20 minuti.

Risposte di Errore

BAD_KEY	Chiave API mancante o errata.
BAD_ACTION	Azione sconosciuta.
BAD_SERVICE	Codice servizio sconosciuto.
BAD_COUNTRY	Il servizio non è venduto in quel paese.
NO_BALANCE	Credito insufficiente.
NO_NUMBERS	Nessun numero disponibile al momento. Riprova tra un attimo.
NO_ACTIVATION	Id di attivazione sconosciuto, o non tuo.
EARLY_CANCEL_DENIED	È già arrivato un codice, quindi l'attivazione non può essere annullata.
TOO_MANY_REQUESTS	Più di 300 richieste in un minuto.
NO_ACTIVATIONS	Sono già aperte 20 attivazioni.

Limiti: 300 richieste al minuto per chiave, fino a 20 attivazioni aperte per account. Prezzi aggiornati al 2026-11-04