API d'activation par SMS

Le format d'activation en texte brut commun, pour les outils qui l'utilisent déjà. Les nouvelles intégrations peuvent également utiliser l'API REST.

Introduction aux numéros de vérification

Chaque appel est une requête GET (ou POST) à https://snsverify.com/stubs/handler_api.php avec votre clé API et un paramètre d'action. La clé provient de la page de clé API de votre console ; gardez-la secrète, elle peut dépenser votre crédit. Les réponses sont de courtes lignes de texte comme ACCESS_NUMBER ou STATUS_OK, ou du JSON pour les actions de liste, exactement comme les autres services utilisant ce format.

Même compte, mêmes règles. Les numéros achetés ici utilisent les mêmes prix, la même fenêtre de 20 minutes et le même remboursement automatique que le site. Les codes de service sont les noms en minuscules que vous voyez sur notre site (whatsapp, telegram, google) ; les codes de pays sont 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) [+]

Votre crédit en USD.

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

Réponse

ACCESS_BALANCE:12.50

getServicesList (GET) [+]

Codes de service que vous pouvez acheter (JSON).

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

Réponse

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

getCountries (GET) [+]

Codes de pays (ISO, minuscules) et indicatifs téléphoniques (JSON).

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

Réponse

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

getPrices (GET) [+]

Prix en USD par pays et service. Les deux filtres sont optionnels.

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

Réponse

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

getNumber (GET) [+]

Achète un numéro. Retourne l'id d'activation et le numéro avec son indicatif pays.

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

Réponse

ACCESS_NUMBER:AC-7K2M9QX4PB:447700900123

getStatus (GET) [+]

STATUS_WAIT_CODE (pas encore de code), STATUS_OK:<code>, STATUS_WAIT_RETRY:<dernier code> (un autre code demandé), STATUS_CANCEL (annulé ou remboursé).

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

Réponse

STATUS_OK:482915

setStatus (GET) [+]

status=1 prêt (ACCESS_READY), 3 un autre code (ACCESS_RETRY_GET), 6 terminé (ACCESS_ACTIVATION), 8 annulation avec remboursement complet si aucun code n'est arrivé (ACCESS_CANCEL).

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

Réponse

ACCESS_RETRY_GET

Déroulement typique

Appelez getNumber avec service et pays. Enregistrez l'id d'activation et donnez le numéro à l'application.
Appelez setStatus avec status=1 lorsque l'application a envoyé le SMS (optionnel, cela marque seulement l'activation comme prête).
Interrogez getStatus toutes les 3 à 5 secondes jusqu'à ce qu'il réponde STATUS_OK avec le code.
Besoin d'un autre code ? setStatus status=3, puis interrogez à nouveau jusqu'à ce que STATUS_OK affiche le nouveau code.
Terminé : setStatus status=6. Pas de code et vous voulez récupérer votre argent maintenant : setStatus status=8 (seulement avant l'arrivée d'un code). Sinon, l'activation se rembourse automatiquement après 20 minutes.

Réponses d'erreur

BAD_KEY	Clé API manquante ou incorrecte.
BAD_ACTION	Action inconnue.
BAD_SERVICE	Code de service inconnu.
BAD_COUNTRY	Le service n'est pas vendu dans ce pays.
NO_BALANCE	Crédit insuffisant.
NO_NUMBERS	Aucun numéro disponible pour le moment. Réessayez dans un instant.
NO_ACTIVATION	Id d'activation inconnu, ou ne vous appartient pas.
EARLY_CANCEL_DENIED	Un code est déjà arrivé, donc l'activation ne peut pas être annulée.
TOO_MANY_REQUESTS	Plus de 300 requêtes en une minute.
NO_ACTIVATIONS	20 activations sont déjà en cours.

Limites : 300 requêtes par minute par clé, jusqu'à 20 activations en cours par compte. Prix au 2026-11-04