URL Dasar https://snsverify.com/api/v1
Setiap path di halaman ini relatif terhadapnya. Jumlah dalam dolar AS sebagai string dengan dua desimal, waktu dalam UTC (ISO 8601).
Dua format, satu akun
Halaman ini menjelaskan REST API dengan JSON. Jika alat Anda sudah menggunakan format aktivasi SMS umum (handler_api.php dengan parameter action=), gunakan API aktivasi SMS. Keduanya berbagi kunci API, harga, aktivasi terbuka, dan pengembalian dana Anda.
Ikhtisar
API verifikasi SMS memungkinkan perangkat lunak Anda membeli nomor telepon untuk suatu aplikasi, menunggu SMS verifikasi, dan membaca kodenya tanpa membuka situs web. Setiap pesanan adalah satu aktivasi: satu layanan, satu negara, satu nomor, dan jendela 20 menit. Pesanan tanpa kode akan dikembalikan sepenuhnya di akhir jendela.
Permintaan menggunakan GET untuk membaca dan POST untuk tindakan. Body POST bisa berupa field form atau JSON. Jawaban sukses adalah objek JSON; error memiliki format yang sama di mana-mana: {"error":{"code":"...","message":"..."}}.
Autentikasi
Buat kunci API di konsol di bawah Kunci API. Kunci hanya ditampilkan sekali; kami hanya menyimpan salinan terenkripsi. Kirim di header Authorization sebagai bearer token. Parameter key juga diterima untuk alat yang tidak bisa mengatur header.
Authorization: Bearer vfk_xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx
Membuat kunci baru akan langsung menggantikan yang lama. Endpoint layanan, negara, dan harga bekerja tanpa kunci.
Kesalahan
| HTTP | Arti |
|---|---|
| 400 | Field hilang atau salah (missing_filter, bad_json). |
| 401 | Tidak ada kunci atau kunci salah (no_key, bad_key). |
| 402 | Saldo tidak cukup (no_balance). |
| 404 | Layanan, negara, pesanan, atau endpoint tidak dikenal. |
| 409 | Pesanan tidak dapat melakukan itu sekarang (has_code, not_ready, too_many_open, no_numbers). |
| 429 | Lebih dari 300 permintaan dalam satu menit (rate_limited). |
Mulai Cepat
Pesan nomor WhatsApp UK dengan curl, lalu periksa pesanan setiap beberapa detik hingga kode muncul.
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);Batas kecepatan
300 permintaan per menit per kunci, dan maksimal 20 pesanan terbuka per akun. Memeriksa pesanan setiap 3 hingga 5 detik sudah cukup: sebagian besar kode tiba dalam satu menit.
Status pesanan
waitingNomor terbuka dan belum ada kode yang tiba.receivedSetidaknya satu kode tiba; minta lagi dengan resend selama jendela masih terbuka.finishedDitutup setelah kode, oleh Anda atau di akhir jendela.refundedJendela berakhir tanpa kode; seluruh harga dikembalikan ke saldo Anda.canceledAnda membatalkan sebelum kode tiba; seluruh harga dikembalikan ke saldo Anda.
Endpoint
GET/services
Setiap kode layanan dengan nama, kategori, dan harga terendah. Tidak perlu kunci.
{"services":[{"code":"whatsapp","name":"WhatsApp","category":"social","from":"0.31"}]}GET/countries
Setiap kode negara (ISO, huruf kecil) dengan nama dan kode telepon. Tidak perlu kunci.
{"countries":[{"code":"gb","name":"United Kingdom","dial_code":"44"}]}GET/prices?service=whatsapp&country=gb
Harga dalam USD. Filter berdasarkan layanan, negara, atau keduanya. Tidak perlu kunci.
{"prices":[{"service":"whatsapp","country":"gb","price":"0.94"}]}GET/balance
Saldo Anda dalam USD.
{"balance":"25.00","currency":"USD"}POST/orders
Membeli nomor (HTTP 201). Mengembalikan pesanan dengan nomor telepon dan waktu jendela berakhir.
Body: service=whatsapp&country=gb
{"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}GET/orders/AC-7K2M9QX4PB
Satu pesanan dengan status dan setiap kode yang diterima. Status: waiting, received, finished, refunded, canceled.
{"order":{"id":"AC-7K2M9QX4PB","status":"received","code":"482915","sms":"Your WhatsApp code: 482-915"}}GET/orders?status=open
Pesanan terbuka Anda; status=all mengembalikan 100 terakhir.
{"orders":[{"id":"AC-7K2M9QX4PB","status":"waiting"}]}POST/orders/AC-7K2M9QX4PB/resend
Meminta kode lain di nomor yang sama setelah kode pertama, selama jendela masih terbuka. Tanpa biaya tambahan.
{"order":{"status":"received","waiting_for_resend":true}}POST/orders/AC-7K2M9QX4PB/finish
Menutup pesanan yang telah menerima kodenya.
{"order":{"status":"finished"}}POST/orders/AC-7K2M9QX4PB/cancel
Membatalkan sebelum kode tiba. Seluruh harga dikembalikan ke saldo Anda.
{"order":{"status":"canceled","refunded":"0.94"}}