SMS वेरिफिकेशन API

सादे HTTP GET या POST अनुरोधों के साथ नंबर खरीदें और SMS कोड पढ़ें। जवाब सामान्य SMS एक्टिवेशन टूल्स के टेक्स्ट फॉर्मेट में होते हैं, प्राइवेट नंबर कॉल्स JSON में जवाब देते हैं।

शुरुआत करना

पता: https://snscodes.com/stubs/handler_api.php
प्रमाणीकरण: api_key पैरामीटर। अपने खाते के API पेज पर कुंजी बनाएं; यह एक बार दिखाई देती है।
दर सीमा: प्रति कुंजी प्रति मिनट 300 अनुरोध
पैसा: मूल्य और क्रेडिट अमेरिकी डॉलर में, वेबसाइट के समान क्रेडिट से लिया गया।

curl "https://snscodes.com/stubs/handler_api.php?api_key=$KEY&action=getNumber&service=telegram&country=us"
# ACCESS_NUMBER:N-7KQ2M9XWD4:14155550123

curl "https://snscodes.com/stubs/handler_api.php?api_key=$KEY&action=getStatus&id=N-7KQ2M9XWD4"
# STATUS_OK:482913

import time, requests
BASE = "https://snscodes.com/stubs/handler_api.php"
KEY = "YOUR_KEY"

r = requests.get(BASE, params={"api_key": KEY, "action": "getNumber", "service": "telegram", "country": "us"}).text
_, num_id, phone = r.split(":")
print("number", phone)
while True:
    s = requests.get(BASE, params={"api_key": KEY, "action": "getStatus", "id": num_id}).text
    if s.startswith("STATUS_OK"):
        print("code", s.split(":")[1]); break
    if s == "STATUS_CANCEL":
        break
    time.sleep(5)

const BASE = "https://snscodes.com/stubs/handler_api.php";
const KEY = process.env.SNSCODES_KEY;
const call = async (q) => (await fetch(BASE + "?" + new URLSearchParams({ api_key: KEY, ...q }))).text();

const [, id, phone] = (await call({ action: "getNumber", service: "telegram", country: "us" })).split(":");
console.log("number", phone);
for (;;) {
  const s = await call({ action: "getStatus", id });
  if (s.startsWith("STATUS_OK")) { console.log("code", s.split(":")[1]); break; }
  if (s === "STATUS_CANCEL") break;
  await new Promise((r) => setTimeout(r, 5000));
}

क्रेडिट प्राप्त करें action=getBalance

अमेरिकी डॉलर में आपके खाते का क्रेडिट लौटाता है।

उत्तर

ACCESS_BALANCE:42.50

BAD_KEYकुंजी गायब है या गलत है।

कोड की कीमतें action=getPrices

देश और सेवा के अनुसार प्रति कोड की कीमतें। दोनों फिल्टर वैकल्पिक हैं।

पैरामीटर	आवश्यक	विवरण
service	नहीं	सेवा कोड, उदाहरण के लिए telegram
country	नहीं	us, gb या au

उत्तर

{"us":{"telegram":{"cost":3,"count":100}}}

एक कोड नंबर खरीदें action=getNumber

एक ऐप के लिए एक नंबर खरीदता है। कीमत आपके क्रेडिट से तुरंत ली जाती है और यदि 20 मिनट में कोई कोड नहीं आता है तो वापस कर दी जाती है।

पैरामीटर	आवश्यक	विवरण
service	हाँ	getPrices से सेवा कोड
country	हाँ	us, gb या au

उत्तर

ACCESS_NUMBER:N-7KQ2M9XWD4:14155550123

BAD_SERVICEअज्ञात सेवा कोड।
BAD_COUNTRYइस देश के लिए सेवा नहीं बेची जाती है।
NO_BALANCEपर्याप्त क्रेडिट नहीं है। कुछ भी चार्ज नहीं किया जाता है।
NO_NUMBERSअभी कोई नंबर उपलब्ध नहीं है। कुछ भी चार्ज नहीं किया जाता है।
NO_ACTIVATIONSआपके पास पहले से ही 20 खुले कोड नंबर हैं।

कोड पढ़ें action=getStatus

कोड आने तक हर 5 से 10 सेकंड में पोल करें।

पैरामीटर	आवश्यक	विवरण
id	हाँ	getNumber से id

उत्तर

STATUS_OK:482913

STATUS_WAIT_CODEअभी तक कोई SMS नहीं।
STATUS_WAIT_RETRY:482913एक और कोड की प्रतीक्षा कर रहा है; अंतिम कोड दिखाया गया है।
STATUS_CANCELरद्द या वापस कर दिया गया।
NO_ACTIVATIONअज्ञात id।

रद्द करें, पुनः प्रयास करें या समाप्त करें action=setStatus

status=8 बिना कोड के नंबर को रद्द करता है (पूर्ण वापसी), status=3 उसी नंबर पर एक और कोड के लिए पूछता है, status=6 इसे समाप्त करता है।

पैरामीटर	आवश्यक	विवरण
id	हाँ	getNumber से id
status	हाँ	8, 3 या 6

उत्तर

ACCESS_CANCEL

EARLY_CANCEL_DENIEDएक कोड पहले ही आ चुका है; रद्द करने के बजाय समाप्त करें।
ACCESS_RETRY_GETएक और कोड की प्रतीक्षा कर रहा है।
ACCESS_ACTIVATIONसमाप्त।

निजी नंबर की कीमतें action=getRentPrices

देश और अवधि के अनुसार पूरी अवधि के लिए कीमत। JSON लौटाता है।

पैरामीटर	आवश्यक	विवरण
country	नहीं	दो-अक्षर देश कोड

उत्तर

{"us":{"sixMonths":35.99,"twelveMonths":59.99}}

एक निजी नंबर खरीदें action=getRentNumber

एक अवधि के लिए एक निजी नंबर खरीदता है। JSON लौटाता है।

पैरामीटर	आवश्यक	विवरण
country	हाँ	दो-अक्षर देश कोड
period	हाँ	oneMonth, threeMonths, sixMonths, twelveMonths, twoYears या threeYears

उत्तर

{"status":"success","id":"N-3HV8QZ2K5M","phone":"14155550123","until":"2027-05-02T10:00:00.000Z"}

BAD_PERIODइस देश के लिए यह अवधि बिक्री में नहीं है।
NO_BALANCEपर्याप्त क्रेडिट नहीं है।

निजी नंबर के SMS पढ़ें action=getRentStatus

अब तक निजी नंबर द्वारा प्राप्त सभी SMS। JSON लौटाता है।

पैरामीटर	आवश्यक	विवरण
id	हाँ	getRentNumber से आईडी

उत्तर

{"status":"success","state":"active","messages":[{"code":"482913","text":"Your code is 482913","from":"Telegram","at":"..."}]}

एक निजी नंबर रद्द करें action=setRentStatus

status=2 एक निजी नंबर को पूर्ण धनवापसी के लिए रद्द करता है जब कोई SMS नहीं आया है और यह 20 मिनट से कम पुराना है।

पैरामीटर	आवश्यक	विवरण
id	हाँ	getRentNumber से आईडी
status	हाँ	2

उत्तर

{"status":"success"}

EARLY_CANCEL_DENIEDएक SMS आ गया है या 20 मिनट बीत चुके हैं।