कंटेंट पर जाएँ
tomnumber

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

अपने सॉफ़्टवेयर से नंबर खरीदें और कोड पढ़ें। API आपका बैलेंस, वही कीमतें और 20 मिनट वाला वही रिफ़ंड नियम इस्तेमाल करता है जो वेबसाइट पर है।

API कुंजी आप अपने अकाउंट में बनाते हैं। API से खरीदे गए नंबर उसी बैलेंस से, वेबसाइट जैसी ही कीमतों पर कटते हैं।

अकाउंट बनाएँAPI कुंजी

$0.0018 प्रति नंबर से

मुख्य बातें

प्रति नंबर सबसे कम कीमत
$0.0018
ऑथेंटिकेशन
API कुंजी
फ़ॉर्मैट
HTTPS पर JSON
रेट लिमिट
प्रति मिनट 120 अनुरोध
रिफ़ंड
वेबसाइट जैसा ही

REST और JSON

छह अनुरोध: बैलेंस, सर्विस, कीमतें, नंबर लेना, स्टेटस और रद्द करना।

आपके अकाउंट की कुंजी

अपने अकाउंट के "API कुंजी" पेज पर कुंजी बनाएँ और उसे Authorization हेडर में भेजें।

वेबसाइट जैसी कीमतें

नंबरों की कीमतें और 20 मिनट वाला रिफ़ंड नियम वेबसाइट जैसा ही है।

कौन से अनुरोध भेज सकते हैं?

पाथ बेस URL के बाद आते हैं। हर अनुरोध में आपकी API कुंजी ज़रूरी है।

कौन से अनुरोध भेज सकते हैं?
मेथड और पाथयह क्या करता है
GET/balanceUSD में आपका बैलेंस
GET/servicesसबसे कम कीमत और देशों की संख्या के साथ सभी सर्विस
GET/prices?service=telegramकिसी सर्विस के लिए हर देश में एक नंबर की कीमत
POST/numbersसर्विस और देश के लिए नंबर लें, कीमत आपके बैलेंस से कटती है
GET/numbers/{id}नंबर का स्टेटस और अब तक मिला हर कोड
POST/numbers/{id}/cancelकोड आने से पहले रद्द करें, कीमत आपके बैलेंस में लौट आती है

API किस क्रम में कॉल करें?

  1. 1

    नंबर लें service और country के साथ POST /numbers भेजें। id और नंबर सेव करें।

  2. 2

    नंबर डालें नंबर उस सर्विस में टाइप करें जो कोड भेजती है।

  3. 3

    कोड जाँचें हर 5 सेकंड में GET /numbers/{id} भेजें, जब तक codes में कोई कोड न आ जाए।

  4. 4

    पूरा करें कोड इस्तेमाल करें। अगर कोड आने से पहले नंबर की ज़रूरत न रहे, तो उसे रद्द कर दें।

API कुंजी कैसे पाएँ?

लॉग इन करें और अपने अकाउंट में "API कुंजी" खोलें। कुंजी बनाएँ और तुरंत कॉपी कर लें, यह सिर्फ़ एक बार दिखती है। नई कुंजी बनाने पर पुरानी बंद हो जाती है।

API कुंजी

बेस URL क्या है?

हर अनुरोध इस पते पर भेजें, कुंजी Authorization हेडर (Bearer) या X-Api-Key हेडर में रखें:

https://tomnumber.com/api/v1
Authorization: Bearer <API_KEY>

अनुरोध के फ़ील्ड

अनुरोध के फ़ील्ड
फ़ील्डकहाँ इस्तेमालवैल्यू
servicePOST /numbers, GET /prices/services से सर्विस का नाम, जैसे telegram
countryPOST /numbersदो अक्षरों का देश कोड, जैसे gb

रिस्पॉन्स फ़ील्ड और स्टेटस

रिस्पॉन्स फ़ील्ड और स्टेटस
वैल्यूमतलब
waitingनंबर खुला है और अभी तक कोई कोड नहीं आया
receivedकम से कम एक कोड आ गया है, expires_at तक और कोड आ सकते हैं
refunded20 मिनट में कोई कोड नहीं आया, कीमत आपके बैलेंस में लौट गई
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" }  ]}

एरर कोड

एरर कोड
unauthorizedAPI कुंजी नहीं है या गलत है
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"

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

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

वेबसाइट की जगह अपने प्रोग्राम से नंबर खरीदने और कोड पढ़ने का तरीका।

क्या API का अलग से पैसा लगता है?

नहीं। नंबरों की कीमत वेबसाइट जैसी ही है और भुगतान उसी बैलेंस से होता है।

मैं कितने अनुरोध भेज सकता हूँ?

हर कुंजी से प्रति मिनट 120 अनुरोध तक। हर 5 सेकंड में जाँचना इस सीमा से काफ़ी नीचे है।

क्या API वाले नंबरों का भी रिफ़ंड होता है?

हाँ, उसी नियम से: 20 मिनट में कोड न आए तो कीमत आपके बैलेंस में लौट आती है।

कुंजी कहाँ बनाएँ?

अपने अकाउंट में "API कुंजी" में।

दूसरी सर्विस के लिए वर्चुअल नंबर