डेवलपर API

बड़े पैमाने पर वेरिफिकेशन स्वचालित करें

SNSPhone API आपके अपने टूल्स को अमेरिकी नॉन-VoIP नंबर ऑर्डर करने, SMS कोड पढ़ने और किराए पर नंबर प्रबंधित करने देता है। दो फॉर्मेट: JSON के साथ एक REST API, और मौजूदा स्क्रिप्ट्स के लिए सामान्य SMS एक्टिवेशन फॉर्मेट।

त्वरित शुरुआत

बेस URL https://snsphone.com/api/v1। कंसोल के API पेज पर एक कुंजी बनाएं और इसे Authorization: Bearer spk_... के रूप में भेजें (या एक कुंजी फील्ड)। सभी नंबर अमेरिकी नॉन-VoIP हैं। धन 2 दशमलव स्थानों के साथ USD स्ट्रिंग है, समय ISO 8601 UTC है, प्रति कुंजी प्रति मिनट 300 अनुरोध। 2026-11-03 तक की कीमतें।

Python

import os, time, requests

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

order = requests.post(f"{API}/orders", headers=H, data={"service": "google"}).json()["order"]
print("Use this US 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://snsphone.com/api/v1";
const H = { Authorization: `Bearer ${process.env.SNSPHONE_KEY}` };

const { order } = await fetch(`${API}/orders`, {
  method: "POST", headers: H, body: new URLSearchParams({ service: "discord" }),
}).then((r) => r.json());
console.log("Use this US 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);

कैटलॉग

GET/services

प्रत्येक सेवा कोड उसके नाम, श्रेणी, वेरिफिकेशन मूल्य और किराए की अवधि के साथ। कुंजी की आवश्यकता नहीं।

सार्वजनिक, कुंजी की आवश्यकता नहीं।

curl "https://snsphone.com/api/v1/services"
{"country":"us","services":[{"code":"whatsapp","name":"WhatsApp","category":"Messaging","verification":"0.90","rentals":[]},{"code":"telegram","name":"Telegram","verification":"0.45","rentals":[{"days":365,"period":"1 year","price":"37.44"}]}]}

GET/prices?service=telegram

USD में कीमतें, वैकल्पिक रूप से एक सेवा के लिए। कुंजी की आवश्यकता नहीं।

सार्वजनिक, कुंजी की आवश्यकता नहीं।

curl "https://snsphone.com/api/v1/prices?service=telegram"
{"country":"us","prices":[{"service":"telegram","type":"verification","days":null,"price":"0.45"},{"service":"telegram","type":"rental","days":365,"price":"37.44"}]}

GET/balance

USD में आपका क्रेडिट।

आपकी API कुंजी की आवश्यकता है।

curl "https://snsphone.com/api/v1/balance" \
  -H "Authorization: Bearer $KEY"
{"balance":"25.00","currency":"USD"}

वेरिफिकेशन

POST/orders

एक वेरिफिकेशन खरीदता है (201)। अमेरिकी नंबर और 20 मिनट की विंडो समाप्त होने का समय लौटाता है।

आपकी API कुंजी की आवश्यकता है।

curl -X POST "https://snsphone.com/api/v1/orders" \
  -H "Authorization: Bearer $KEY" \
  -d "service=whatsapp"
{"order":{"id":"VR-7K2M9QX4PB","service":"whatsapp","country":"us","phone":"+14155550142","number":"4155550142","status":"waiting","code":null,"expires_at":"2026-11-03T12:20:00.000Z"},"window_minutes":20}

GET/orders/VR-7K2M9QX4PB

एक वेरिफिकेशन उसकी स्थिति और प्राप्त हुए प्रत्येक कोड के साथ। स्थितियाँ: waiting, received, finished, refunded, canceled।

आपकी API कुंजी की आवश्यकता है।

curl "https://snsphone.com/api/v1/orders/VR-7K2M9QX4PB" \
  -H "Authorization: Bearer $KEY"
{"order":{"id":"VR-7K2M9QX4PB","status":"received","code":"482913","sms":"Your WhatsApp code is 482913"}}

GET/orders?status=open

आपके खुले वेरिफिकेशन (status=all पिछले 100 के लिए)।

आपकी API कुंजी की आवश्यकता है।

curl "https://snsphone.com/api/v1/orders?status=open" \
  -H "Authorization: Bearer $KEY"
{"orders":[...]}

POST/orders/VR-7K2M9QX4PB/resend

उसी नंबर पर एक और कोड के लिए अनुरोध करता है, पहले कोड के बाद और जब विंडो खुली हो। कोई अतिरिक्त शुल्क नहीं।

आपकी API कुंजी की आवश्यकता है।

curl -X POST "https://snsphone.com/api/v1/orders/VR-7K2M9QX4PB/resend" \
  -H "Authorization: Bearer $KEY"
{"order":{"status":"received","waiting_for_resend":true}}

POST/orders/VR-7K2M9QX4PB/finish

एक वेरिफिकेशन को बंद करता है जिसने अपना कोड प्राप्त कर लिया है।

आपकी API कुंजी की आवश्यकता है।

curl -X POST "https://snsphone.com/api/v1/orders/VR-7K2M9QX4PB/finish" \
  -H "Authorization: Bearer $KEY"
{"order":{"status":"finished"}}

POST/orders/VR-7K2M9QX4PB/cancel

कोड आने से पहले रद्द करता है। पूरी राशि आपके क्रेडिट में वापस चली जाती है।

आपकी API कुंजी की आवश्यकता है।

curl -X POST "https://snsphone.com/api/v1/orders/VR-7K2M9QX4PB/cancel" \
  -H "Authorization: Bearer $KEY"
{"order":{"status":"canceled","refunded":"0.90"}}

किराए पर

POST/rentals

एक सेवा और अवधि के लिए अमेरिकी नंबर किराए पर लेता है (201)। days वैकल्पिक है जब सेवा की एक अवधि हो।

आपकी API कुंजी की आवश्यकता है।

curl -X POST "https://snsphone.com/api/v1/rentals" \
  -H "Authorization: Bearer $KEY" \
  -d "service=telegram&days=365"
{"rental":{"id":"RN-4J8T2W6QHM","service":"telegram","phone":"+13125550198","days":365,"period":"1 year","price":"37.44","status":"active","ends_at":"2027-11-03T12:00:00.000Z","messages":[]}}

GET/rentals?status=active

आपके सक्रिय किराए पर नंबर उनके नवीनतम संदेशों के साथ (status=all पिछले 100 के लिए)।

आपकी API कुंजी की आवश्यकता है।

curl "https://snsphone.com/api/v1/rentals?status=active" \
  -H "Authorization: Bearer $KEY"
{"rentals":[...]}

GET/rentals/RN-4J8T2W6QHM

एक किराए पर नंबर उस पर प्राप्त हुए प्रत्येक SMS के साथ।

आपकी API कुंजी की आवश्यकता है।

curl "https://snsphone.com/api/v1/rentals/RN-4J8T2W6QHM" \
  -H "Authorization: Bearer $KEY"
{"rental":{"id":"RN-4J8T2W6QHM","status":"active","messages":[{"from":"Telegram","sms":"Telegram code: 57291","code":"57291","received_at":"2026-11-03T12:01:12.000Z"}]}}

POST/rentals/RN-4J8T2W6QHM/renew

एक और अवधि उसी कीमत पर जोड़ता है।

आपकी API कुंजी की आवश्यकता है।

curl -X POST "https://snsphone.com/api/v1/rentals/RN-4J8T2W6QHM/renew" \
  -H "Authorization: Bearer $KEY"
{"rental":{"renewed":1,"ends_at":"2028-11-02T12:00:00.000Z"}}

POST/rentals/RN-4J8T2W6QHM/cancel

पहले 20 मिनट में रद्द करता है जब कोई SMS नहीं आया है। भुगतान की गई सारी राशि आपके क्रेडिट में वापस चली जाती है।

आपकी API कुंजी की आवश्यकता है।

curl -X POST "https://snsphone.com/api/v1/rentals/RN-4J8T2W6QHM/cancel" \
  -H "Authorization: Bearer $KEY"
{"rental":{"status":"canceled","refunded":"37.44"}}

SMS एक्टिवेशन फॉर्मेट

उन टूल्स के लिए जो पहले से ही सामान्य एक्टिवेशन फॉर्मेट समझते हैं। एक URL, एक action फील्ड, सादा पाठ उत्तर। केवल वेरिफिकेशन।

https://snsphone.com/stubs/handler_api.php?api_key=KEY&action=ACTION
क्रियाअतिरिक्त फील्ड्सउत्तरअर्थ
getBalanceकोई नहींACCESS_BALANCE:12.50USD में आपका क्रेडिट।
getServicesListकोई नहीं{"status":"success","services":[{"code":"whatsapp","name":"WhatsApp"}]}वेरिफिकेशन मूल्य के साथ सेवा कोड (JSON)।
getCountriesकोई नहीं{"us":{"name":"United States","dial":"1"}}केवल संयुक्त राज्य अमेरिका। country us, 187 हो सकता है या छोड़ा जा सकता है।
getPrices&service=whatsapp{"us":{"whatsapp":{"cost":0.9,"count":100}}}USD में कीमतें। सेवा फिल्टर वैकल्पिक है।
getNumber&service=whatsapp&country=usACCESS_NUMBER:VR-7K2M9QX4PB:14155550142एक वेरिफिकेशन खरीदता है। id और 1 के सामने वाला नंबर लौटाता है।
getStatus&id=VR-7K2M9QX4PBSTATUS_OK:482913STATUS_WAIT_CODE, STATUS_OK:<code>, STATUS_WAIT_RETRY:<last code> (एक और कोड का अनुरोध किया गया), STATUS_CANCEL (रद्द या रिफंड किया गया)।
setStatus&id=VR-7K2M9QX4PB&status=3ACCESS_RETRY_GETstatus=1 तैयार (ACCESS_READY), 3 एक और कोड (ACCESS_RETRY_GET), 6 समाप्त (ACCESS_ACTIVATION), 8 कोई कोड न आने पर पूर्ण रिफंड के साथ रद्द (ACCESS_CANCEL)।

त्रुटियाँ

REST त्रुटियाँ {"error":{"code","message"}} के रूप में इन स्थिति कोड्स के साथ आती हैं। एक्टिवेशन फॉर्मेट एक सादे शब्द के साथ उत्तर देता है।

400गुम या गलत फील्ड (bad_json, bad_period).
401कोई की नहीं या गलत की (no_key, bad_key).
402पर्याप्त क्रेडिट नहीं (no_balance).
404अज्ञात सेवा, ऑर्डर, किराया या एंडपॉइंट, या ऐसा उत्पाद जो सेवा के पास नहीं है (not_sold).
409अभी संभव नहीं (has_code, has_sms, too_late, not_ready, too_many_open, too_many_active, no_numbers).
429एक मिनट में 300 से अधिक अनुरोध (rate_limited).
BAD_KEYगुम या गलत API की.
BAD_ACTIONअज्ञात क्रिया।
BAD_SERVICEअज्ञात सेवा कोड।
BAD_COUNTRYसंयुक्त राज्य अमेरिका नहीं, या सेवा केवल किराए पर उपलब्ध है।
NO_BALANCEपर्याप्त क्रेडिट नहीं।
NO_NUMBERSफिलहाल कोई नंबर उपलब्ध नहीं है। कुछ देर बाद पुनः प्रयास करें।
NO_ACTIVATIONअज्ञात आईडी, या आपका नहीं।
EARLY_CANCEL_DENIEDकोड पहले ही आ चुका है, इसलिए इसे रद्द नहीं किया जा सकता।
NO_ACTIVATIONS20 वेरिफिकेशन पहले से ही खुले हैं।
TOO_MANY_REQUESTSएक मिनट में 300 से अधिक अनुरोध।

API प्रश्न

कुंजियाँ, सीमाएँ और पोलिंग, उत्तर दिए गए।

क्या SNSPhone के पास SMS वेरिफिकेशन API है?

हाँ। एक REST API जो JSON में /api/v1 पर सेवाओं, कीमतों, वेरिफिकेशन और किराया के लिए उपलब्ध है, और सामान्य SMS एक्टिवेशन फॉर्मेट /stubs/handler_api.php पर।

API अनुरोधों की प्रमाणीकरण कैसे करें?

कंसोल के API पेज पर एक की बनाएं और इसे Authorization: Bearer spk_... के रूप में भेजें, या key फील्ड के रूप में। कुंजियाँ केवल हैश के रूप में संग्रहीत की जाती हैं और एक बार दिखाई जाती हैं।

API की दर सीमाएँ क्या हैं?

प्रति मिनट 300 अनुरोध प्रति की, प्रति खाता 20 खुले वेरिफिकेशन और 20 सक्रिय किराए तक।

क्या API ऑर्डर वेबसाइट ऑर्डर से अधिक महंगे हैं?

नहीं। API वही कीमतें और वही रिफंड नियम उपयोग करता है जो कंसोल करता है।

मुझे कैसे पता चलेगा कि कोड आ गया है?

हर कुछ सेकंड में GET /orders/{id} पोल करें। स्थिति waiting से received में बदल जाएगी और code फील्ड में अंक होंगे।

नॉन-VoIP SMS वेरिफिकेशन API: REST द्वारा US नंबर | SNSPhone