बेस URL https://snsverify.com/api/v1
इस पेज पर हर पथ इसके सापेक्ष है। राशियाँ US डॉलर में स्ट्रिंग के रूप में दो दशमलव स्थानों के साथ हैं, समय UTC (ISO 8601) में हैं।
दो फॉर्मेट, एक खाता
यह पृष्ठ JSON के साथ REST API का वर्णन करता है। यदि आपका टूल पहले से ही सामान्य एसएमएस सक्रियण प्रारूप (handler_api.php के साथ action= पैरामीटर) का उपयोग करता है, तो एसएमएस सक्रियण API का उपयोग करें। दोनों आपकी API कुंजी, मूल्य, खुले सक्रियण और धनवापसी साझा करते हैं।
अवलोकन
एक SMS वेरिफिकेशन API आपके सॉफ्टवेयर को एक ऐप के लिए एक फोन नंबर खरीदने, वेरिफिकेशन SMS का इंतजार करने और कोड पढ़ने की अनुमति देता है, वेबसाइट खोले बिना। हर ऑर्डर एक एक्टिवेशन है: एक सेवा, एक देश, एक नंबर और एक 20 मिनट का विंडो। कोड के बिना ऑर्डर विंडो के अंत में पूरी कीमत वापस कर दी जाती है।
अनुरोध पढ़ने के लिए GET और कार्रवाई के लिए POST का उपयोग करते हैं। POST बॉडी फॉर्म फील्ड या JSON हो सकते हैं। सफल उत्तर JSON ऑब्जेक्ट हैं; त्रुटियाँ हर जगह एक ही आकार की हैं: {"error":{"code":"...","message":"..."}}.
प्रमाणीकरण
कंसोल में API key के तहत एक API key बनाएं। यह एक बार दिखाया जाता है; हम केवल एक स्क्रैम्बल्ड कॉपी रखते हैं। इसे Authorization हेडर में बेयरर टोकन के रूप में भेजें। एक key पैरामीटर भी उन टूल्स के लिए स्वीकार किया जाता है जो हेडर सेट नहीं कर सकते।
Authorization: Bearer vfk_xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx
एक नई key बनाने से पुरानी key तुरंत बदल जाती है। सेवाएँ, देश और कीमतें एंडपॉइंट्स key के बिना काम करते हैं।
त्रुटियाँ
| HTTP | अर्थ |
|---|---|
| 400 | गुम या गलत फील्ड (missing_filter, bad_json)। |
| 401 | कोई key नहीं या गलत key (no_key, bad_key)। |
| 402 | पर्याप्त क्रेडिट नहीं (no_balance)। |
| 404 | अज्ञात सेवा, देश, ऑर्डर या एंडपॉइंट। |
| 409 | ऑर्डर अभी यह नहीं कर सकता (has_code, not_ready, too_many_open, no_numbers)। |
| 429 | एक मिनट में 300 से अधिक अनुरोध (rate_limited)। |
त्वरित प्रारंभ
curl के साथ एक UK WhatsApp नंबर ऑर्डर करें, फिर कोड आने तक हर कुछ सेकंड में ऑर्डर को पोल करें।
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);दर सीमाएँ
प्रति key प्रति मिनट 300 अनुरोध, और प्रति खाता 20 खुले ऑर्डर तक। हर 3 से 5 सेकंड में एक ऑर्डर को पोल करना पर्याप्त है: अधिकांश कोड एक मिनट के भीतर आ जाते हैं।
ऑर्डर स्थितियाँ
waitingनंबर खुला है और अभी तक कोई कोड नहीं आया है।receivedकम से कम एक कोड आ गया है; विंडो खुला होने पर resend के साथ एक और कोड मांगें।finishedएक कोड के बाद बंद, आपके द्वारा या विंडो के अंत में।refundedविंडो कोड के बिना समाप्त हो गई; पूरी कीमत आपके क्रेडिट में वापस चली गई।canceledआपने कोड आने से पहले रद्द कर दिया; पूरी कीमत आपके क्रेडिट में वापस चली गई।
एंडपॉइंट्स
GET/services
हर सेवा कोड उसके नाम, श्रेणी और सबसे कम कीमत के साथ। key की आवश्यकता नहीं है।
{"services":[{"code":"whatsapp","name":"WhatsApp","category":"social","from":"0.31"}]}GET/countries
हर देश कोड (ISO, लोअर केस) नाम और डायल कोड के साथ। key की आवश्यकता नहीं है।
{"countries":[{"code":"gb","name":"United Kingdom","dial_code":"44"}]}GET/prices?service=whatsapp&country=gb
USD में कीमतें। सेवा, देश या दोनों से फ़िल्टर करें। key की आवश्यकता नहीं है।
{"prices":[{"service":"whatsapp","country":"gb","price":"0.94"}]}GET/balance
USD में आपका क्रेडिट।
{"balance":"25.00","currency":"USD"}POST/orders
एक नंबर खरीदता है (HTTP 201)। फोन नंबर और विंडो समाप्त होने का समय के साथ ऑर्डर लौटाता है।
बॉडी: 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
एक ऑर्डर उसकी स्थिति और प्राप्त हर कोड के साथ। स्थितियाँ: waiting, received, finished, refunded, canceled।
{"order":{"id":"AC-7K2M9QX4PB","status":"received","code":"482915","sms":"Your WhatsApp code: 482-915"}}GET/orders?status=open
आपके खुले ऑर्डर; status=all अंतिम 100 लौटाता है।
{"orders":[{"id":"AC-7K2M9QX4PB","status":"waiting"}]}POST/orders/AC-7K2M9QX4PB/resend
पहले कोड के बाद एक ही नंबर पर एक और कोड मांगता है, जबकि विंडो खुला है। कोई अतिरिक्त शुल्क नहीं।
{"order":{"status":"received","waiting_for_resend":true}}POST/orders/AC-7K2M9QX4PB/finish
एक ऑर्डर बंद करता है जिसने अपना कोड प्राप्त कर लिया है।
{"order":{"status":"finished"}}POST/orders/AC-7K2M9QX4PB/cancel
कोड आने से पहले रद्द करता है। पूरी कीमत आपके क्रेडिट में वापस चली जाती है।
{"order":{"status":"canceled","refunded":"0.94"}}