- होम
- API
SMS वेरिफ़िकेशन API
अपने सॉफ़्टवेयर से नंबर खरीदें और कोड पढ़ें। API आपका बैलेंस, वही कीमतें और 20 मिनट वाला वही रिफ़ंड नियम इस्तेमाल करता है जो वेबसाइट पर है।
API कुंजी आप अपने अकाउंट में बनाते हैं। API से खरीदे गए नंबर उसी बैलेंस से, वेबसाइट जैसी ही कीमतों पर कटते हैं।
मुख्य बातें
- प्रति नंबर सबसे कम कीमत
- $0.0018
- ऑथेंटिकेशन
- API कुंजी
- फ़ॉर्मैट
- HTTPS पर JSON
- रेट लिमिट
- प्रति मिनट 120 अनुरोध
- रिफ़ंड
- वेबसाइट जैसा ही
REST और JSON
छह अनुरोध: बैलेंस, सर्विस, कीमतें, नंबर लेना, स्टेटस और रद्द करना।
आपके अकाउंट की कुंजी
अपने अकाउंट के "API कुंजी" पेज पर कुंजी बनाएँ और उसे Authorization हेडर में भेजें।
वेबसाइट जैसी कीमतें
नंबरों की कीमतें और 20 मिनट वाला रिफ़ंड नियम वेबसाइट जैसा ही है।
कौन से अनुरोध भेज सकते हैं?
पाथ बेस URL के बाद आते हैं। हर अनुरोध में आपकी API कुंजी ज़रूरी है।
| मेथड और पाथ | यह क्या करता है |
|---|---|
GET/ | USD में आपका बैलेंस |
GET/ | सबसे कम कीमत और देशों की संख्या के साथ सभी सर्विस |
GET/ | किसी सर्विस के लिए हर देश में एक नंबर की कीमत |
POST/ | सर्विस और देश के लिए नंबर लें, कीमत आपके बैलेंस से कटती है |
GET/ | नंबर का स्टेटस और अब तक मिला हर कोड |
POST/ | कोड आने से पहले रद्द करें, कीमत आपके बैलेंस में लौट आती है |
API किस क्रम में कॉल करें?
- 1
नंबर लें service और country के साथ POST /numbers भेजें। id और नंबर सेव करें।
- 2
नंबर डालें नंबर उस सर्विस में टाइप करें जो कोड भेजती है।
- 3
कोड जाँचें हर 5 सेकंड में GET /numbers/{id} भेजें, जब तक codes में कोई कोड न आ जाए।
- 4
पूरा करें कोड इस्तेमाल करें। अगर कोड आने से पहले नंबर की ज़रूरत न रहे, तो उसे रद्द कर दें।
API कुंजी कैसे पाएँ?
लॉग इन करें और अपने अकाउंट में "API कुंजी" खोलें। कुंजी बनाएँ और तुरंत कॉपी कर लें, यह सिर्फ़ एक बार दिखती है। नई कुंजी बनाने पर पुरानी बंद हो जाती है।
API कुंजीबेस URL क्या है?
हर अनुरोध इस पते पर भेजें, कुंजी Authorization हेडर (Bearer) या X-Api-Key हेडर में रखें:
https://tomnumber.com/api/v1Authorization: Bearer <API_KEY>अनुरोध के फ़ील्ड
| फ़ील्ड | कहाँ इस्तेमाल | वैल्यू |
|---|---|---|
service | POST /numbers, GET /prices | /services से सर्विस का नाम, जैसे telegram |
country | POST /numbers | दो अक्षरों का देश कोड, जैसे gb |
रिस्पॉन्स फ़ील्ड और स्टेटस
| वैल्यू | मतलब |
|---|---|
waiting | नंबर खुला है और अभी तक कोई कोड नहीं आया |
received | कम से कम एक कोड आ गया है, expires_at तक और कोड आ सकते हैं |
refunded | 20 मिनट में कोई कोड नहीं आया, कीमत आपके बैलेंस में लौट गई |
canceled | कोड आने से पहले आपने रद्द किया, कीमत आपके बैलेंस में लौट गई |
रिस्पॉन्स का उदाहरण
{ "ok": true, "id": "R8KQ2M7XWD4P", "service": "telegram", "country": "gb", "number": "+44 7700 900412", "price": "0.167", "status": "received", "expires_at": "2026-11-11T09:20:00.000Z", "codes": [ { "code": "483920", "text": "Telegram code: 483920", "received_at": "2026-11-11T09:01:12.000Z" } ]}एरर कोड
unauthorized | API कुंजी नहीं है या गलत है |
rate_limited | एक मिनट में 120 से ज़्यादा अनुरोध |
bad_service | अनजान सर्विस नाम |
bad_country | उस सर्विस के लिए यह देश उपलब्ध नहीं है |
low_balance | बैलेंस कीमत से कम है |
unavailable | अभी कोई नंबर उपलब्ध नहीं है। कोई पैसा नहीं कटा |
not_found | आपके अकाउंट में इस id का कोई नंबर नहीं है |
cannot_cancel | कोड पहले ही आ चुका है या नंबर बंद है |
कोड के उदाहरण
# get a numbercurl -X POST https://tomnumber.com/api/v1/numbers \ -H "Authorization: Bearer $API_KEY" \ -H "Content-Type: application/json" \ -d '{"service":"telegram","country":"gb"}' # check for codescurl https://tomnumber.com/api/v1/numbers/R8KQ2M7XWD4P \ -H "Authorization: Bearer $API_KEY"const api = (path, init = {}) => fetch("https://tomnumber.com/api/v1" + path, { ...init, headers: { Authorization: "Bearer " + process.env.API_KEY, "Content-Type": "application/json" }, }).then((r) => r.json()); const n = await api("/numbers", { method: "POST", body: JSON.stringify({ service: "telegram", country: "gb" }) });console.log(n.number); // enter this number in the app let codes = [];while (!codes.length) { await new Promise((r) => setTimeout(r, 5000)); const s = await api("/numbers/" + n.id); if (s.status === "refunded" || s.status === "canceled") break; codes = s.codes;}console.log(codes.map((c) => c.code));import os, time, requests API = "https://tomnumber.com/api/v1"H = {"Authorization": "Bearer " + os.environ["API_KEY"]} n = requests.post(API + "/numbers", json={"service": "telegram", "country": "gb"}, headers=H).json()print(n["number"]) # enter this number in the app while True: time.sleep(5) s = requests.get(API + "/numbers/" + n["id"], headers=H).json() if s["codes"] or s["status"] in ("refunded", "canceled"): breakprint([c["code"] for c in s["codes"]])SMS वेरिफ़िकेशन API FAQ
SMS वेरिफ़िकेशन API क्या है?
वेबसाइट की जगह अपने प्रोग्राम से नंबर खरीदने और कोड पढ़ने का तरीका।
क्या API का अलग से पैसा लगता है?
नहीं। नंबरों की कीमत वेबसाइट जैसी ही है और भुगतान उसी बैलेंस से होता है।
मैं कितने अनुरोध भेज सकता हूँ?
हर कुंजी से प्रति मिनट 120 अनुरोध तक। हर 5 सेकंड में जाँचना इस सीमा से काफ़ी नीचे है।
क्या API वाले नंबरों का भी रिफ़ंड होता है?
हाँ, उसी नियम से: 20 मिनट में कोड न आए तो कीमत आपके बैलेंस में लौट आती है।
कुंजी कहाँ बनाएँ?
अपने अकाउंट में "API कुंजी" में।