208 ऐप्स154 देश

API v12026-11-04

सत्यापन नंबर ऑर्डर करने और SMS कोड पढ़ने के लिए एक JSON API।

बेस 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"}}
SMS वेरिफिकेशन API: WhatsApp, Telegram और Google नंबरों के लिए REST JSON | SNSVerify