API v12026-11-04

Authentification

Créez une clé API dans la console sous Clé API. Elle n'est affichée qu'une fois ; nous ne conservons qu'une copie brouillée. Envoyez-la dans l'en-tête Authorization en tant que jeton porteur. Un paramètre key est également accepté pour les outils qui ne peuvent pas définir d'en-têtes.

Authorization: Bearer vfk_xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx

La création d'une nouvelle clé remplace immédiatement l'ancienne. Les points de terminaison des services, des pays et des prix fonctionnent sans clé.

Erreurs

Démarrage rapide

Commander un numéro WhatsApp UK avec curl, puis interroger la commande toutes les quelques secondes jusqu'à ce que le code arrive.

curl -X POST https://snsverify.com/api/v1/orders \
  -H "Authorization: Bearer $SNSVERIFY_KEY" \
  -d service=whatsapp -d country=gb

Python

import os, time, requests

API = "https://snsverify.com/api/v1"
H = {"Authorization": f"Bearer {os.environ['SNSVERIFY_KEY']}"}

order = requests.post(f"{API}/orders", headers=H,
    data={"service": "whatsapp", "country": "gb"}).json()["order"]
print("Use this number:", order["phone"])

while True:
    o = requests.get(f"{API}/orders/{order['id']}", headers=H).json()["order"]
    if o["code"] or o["status"] in ("refunded", "canceled"):
        break
    time.sleep(4)
print("Code:", o["code"])

Node.js

const API = "https://snsverify.com/api/v1";
const H = { Authorization: `Bearer ${process.env.SNSVERIFY_KEY}` };

const { order } = await fetch(`${API}/orders`, {
  method: "POST", headers: H,
  body: new URLSearchParams({ service: "telegram", country: "nl" }),
}).then((r) => r.json());
console.log("Use this number:", order.phone);

let o = order;
while (!o.code && !["refunded", "canceled"].includes(o.status)) {
  await new Promise((r) => setTimeout(r, 4000));
  ({ order: o } = await fetch(`${API}/orders/${order.id}`, { headers: H }).then((r) => r.json()));
}
console.log("Code:", o.code);

Limites de taux

300 requêtes par minute par clé, et jusqu'à 20 commandes en cours par compte. Interroger une commande toutes les 3 à 5 secondes est largement suffisant : la plupart des codes arrivent en moins d'une minute.

Statuts de commande

• waiting Le numéro est ouvert et aucun code n'est encore arrivé.
• received Au moins un code est arrivé ; demandez-en un autre avec resend tant que la fenêtre est ouverte.
• finished Fermé après un code, par vous ou à la fin de la fenêtre.
• refunded La fenêtre s'est terminée sans code ; le montant total est revenu sur votre crédit.
• canceled Vous avez annulé avant qu'un code n'arrive ; le montant total est revenu sur votre crédit.

Points de terminaison

{"services":[{"code":"whatsapp","name":"WhatsApp","category":"social","from":"0.31"}]}

{"countries":[{"code":"gb","name":"United Kingdom","dial_code":"44"}]}

{"prices":[{"service":"whatsapp","country":"gb","price":"0.94"}]}

{"balance":"25.00","currency":"USD"}

{"order":{"id":"AC-7K2M9QX4PB","service":"whatsapp","country":"gb","phone":"+447700900123","price":"0.94","status":"waiting","code":null,"expires_at":"2026-11-04T12:20:00.000Z"},"window_minutes":20}

{"order":{"id":"AC-7K2M9QX4PB","status":"received","code":"482915","sms":"Your WhatsApp code: 482-915"}}

{"orders":[{"id":"AC-7K2M9QX4PB","status":"waiting"}]}

{"order":{"status":"received","waiting_for_resend":true}}

{"order":{"status":"finished"}}

{"order":{"status":"canceled","refunded":"0.94"}}