Temp Number API - फ़ोन नंबर, SMS और OTP
वर्चुअल फ़ोन नंबर प्राप्त करें, रीयल-टाइम में SMS पाएँ और OTP वेरिफ़िकेशन ऑटोमेट करें - एक साफ़ REST API से, या सीधे अपने AI असिस्टेंट से।
https://api.temp-number.com/v1
होम / डेवलपर्स
परिचय
Temp Number API अनुमानित संसाधनों के आधार पर व्यवस्थित है, मानक HTTP verbs इस्तेमाल करता है और हर जवाब JSON में लौटाता है। एक कुंजी केवल आपके अपने खाते को पढ़ने और लिखने की पहुँच देती है - किसी दूसरे खाते तक पहुँच नहीं है।
क्विकस्टार्ट
शून्य से वेरिफ़िकेशन कोड तक। अपनी भाषा एक बार चुनें - पेज का हर उदाहरण उसी में दिखेगा।
-
API कुंजी बनाएँ
Dashboard → API Access में एक कुंजी बनाएँ। यह एक बार दिखाई जाती है: इसे एनवायरनमेंट वेरिएबल
TEMP_NUMBER_API_KEYके रूप में सेव करें। -
अपना बैलेंस जाँचें
हर कॉल में आपकी कुंजी Authorization हेडर में जाती है। किसी हानिरहित चीज़ से शुरुआत करें: आपका वॉलेट बैलेंस।
curl --request GET "https://api.temp-number.com/v1/account" \ --header "Authorization: Bearer $TEMP_NUMBER_API_KEY" \ --header "Accept: application/json"const response = await fetch("https://api.temp-number.com/v1/account", { headers: { Authorization: `Bearer ${process.env.TEMP_NUMBER_API_KEY}`, Accept: "application/json", }, }); const result = await response.json(); console.log(response.status, result);import os import requests response = requests.get( "https://api.temp-number.com/v1/account", headers={ "Authorization": f"Bearer {os.environ['TEMP_NUMBER_API_KEY']}", "Accept": "application/json", }, timeout=30, ) print(response.status_code, response.json())use Illuminate\Support\Facades\Http; // config/services.php: 'temp_number' => ['key' => env('TEMP_NUMBER_API_KEY')] $response = Http::withToken(config('services.temp_number.key')) ->acceptJson() ->get('https://api.temp-number.com/v1/account'); $result = $response->json(); -
देश चुनें और स्टॉक जाँचें
GET /pricing हर देश को हर अवधि की सटीक कीमत के साथ दिखाता है। फिर अपने चुने हुए देश का स्टॉक पक्का करें।
curl --request GET "https://api.temp-number.com/v1/inventory?country_code=US&duration=oneMonth" \ --header "Authorization: Bearer $TEMP_NUMBER_API_KEY" \ --header "Accept: application/json"const response = await fetch("https://api.temp-number.com/v1/inventory?country_code=US&duration=oneMonth", { headers: { Authorization: `Bearer ${process.env.TEMP_NUMBER_API_KEY}`, Accept: "application/json", }, }); const result = await response.json(); console.log(response.status, result);import os import requests response = requests.get( "https://api.temp-number.com/v1/inventory", headers={ "Authorization": f"Bearer {os.environ['TEMP_NUMBER_API_KEY']}", "Accept": "application/json", }, params={"country_code": "US", "duration": "oneMonth"}, timeout=30, ) print(response.status_code, response.json())use Illuminate\Support\Facades\Http; // config/services.php: 'temp_number' => ['key' => env('TEMP_NUMBER_API_KEY')] $response = Http::withToken(config('services.temp_number.key')) ->acceptJson() ->get('https://api.temp-number.com/v1/inventory', [ 'country_code' => 'US', 'duration' => 'oneMonth', ]); $result = $response->json(); -
नंबर खरीदें
हर खरीदारी के साथ एक नई Idempotency-Key भेजें। अगर नेटवर्क टूट जाए, तो उसी कुंजी के साथ फिर से प्रयास करें: आपसे कभी दो बार शुल्क नहीं लिया जाता। जवाब से data.id सहेज लें।
curl --request POST "https://api.temp-number.com/v1/numbers/buy" \ --header "Authorization: Bearer $TEMP_NUMBER_API_KEY" \ --header "Accept: application/json" \ --header "Content-Type: application/json" \ --header "Idempotency-Key: $(uuidgen)" \ --data '{"country_code":"US","duration":"oneMonth"}'import { randomUUID } from "node:crypto"; const response = await fetch("https://api.temp-number.com/v1/numbers/buy", { method: "POST", headers: { Authorization: `Bearer ${process.env.TEMP_NUMBER_API_KEY}`, Accept: "application/json", "Content-Type": "application/json", "Idempotency-Key": randomUUID(), }, body: JSON.stringify({ country_code: "US", duration: "oneMonth" }), }); const result = await response.json(); console.log(response.status, result);import os import uuid import requests response = requests.post( "https://api.temp-number.com/v1/numbers/buy", headers={ "Authorization": f"Bearer {os.environ['TEMP_NUMBER_API_KEY']}", "Accept": "application/json", "Idempotency-Key": str(uuid.uuid4()), }, json={"country_code": "US", "duration": "oneMonth"}, timeout=60, ) print(response.status_code, response.json())use Illuminate\Support\Facades\Http; use Illuminate\Support\Str; // config/services.php: 'temp_number' => ['key' => env('TEMP_NUMBER_API_KEY')] $response = Http::withToken(config('services.temp_number.key')) ->acceptJson() ->withHeaders(['Idempotency-Key' => (string) Str::uuid()]) ->timeout(60) ->post('https://api.temp-number.com/v1/numbers/buy', [ 'country_code' => 'US', 'duration' => 'oneMonth', ]); $result = $response->json(); -
SMS पढ़ें
संदेश आने तक हर कुछ सेकंड में नंबर को पोल करें। आपको मूल टेक्स्ट मिलता है; कोड आप अपनी ओर से निकालें।
curl --request GET "https://api.temp-number.com/v1/numbers/1482/sms" \ --header "Authorization: Bearer $TEMP_NUMBER_API_KEY" \ --header "Accept: application/json"const response = await fetch("https://api.temp-number.com/v1/numbers/1482/sms", { headers: { Authorization: `Bearer ${process.env.TEMP_NUMBER_API_KEY}`, Accept: "application/json", }, }); const result = await response.json(); console.log(response.status, result);import os import requests response = requests.get( "https://api.temp-number.com/v1/numbers/1482/sms", headers={ "Authorization": f"Bearer {os.environ['TEMP_NUMBER_API_KEY']}", "Accept": "application/json", }, timeout=30, ) print(response.status_code, response.json())use Illuminate\Support\Facades\Http; // config/services.php: 'temp_number' => ['key' => env('TEMP_NUMBER_API_KEY')] $response = Http::withToken(config('services.temp_number.key')) ->acceptJson() ->get('https://api.temp-number.com/v1/numbers/1482/sms'); $result = $response->json(); -
SMS नहीं आया? रिफ़ंड के लिए रद्द करें
खरीद के 15 से 120 मिनट के बीच, जिस नंबर पर कोई SMS नहीं आया है उसे रद्द करके पूरी राशि वॉलेट में रिफ़ंड पाई जा सकती है।
curl --request POST "https://api.temp-number.com/v1/numbers/1482/cancel" \ --header "Authorization: Bearer $TEMP_NUMBER_API_KEY" \ --header "Accept: application/json" \ --header "Idempotency-Key: $(uuidgen)"import { randomUUID } from "node:crypto"; const response = await fetch("https://api.temp-number.com/v1/numbers/1482/cancel", { method: "POST", headers: { Authorization: `Bearer ${process.env.TEMP_NUMBER_API_KEY}`, Accept: "application/json", "Idempotency-Key": randomUUID(), }, }); const result = await response.json(); console.log(response.status, result);import os import uuid import requests response = requests.post( "https://api.temp-number.com/v1/numbers/1482/cancel", headers={ "Authorization": f"Bearer {os.environ['TEMP_NUMBER_API_KEY']}", "Accept": "application/json", "Idempotency-Key": str(uuid.uuid4()), }, timeout=60, ) print(response.status_code, response.json())use Illuminate\Support\Facades\Http; use Illuminate\Support\Str; // config/services.php: 'temp_number' => ['key' => env('TEMP_NUMBER_API_KEY')] $response = Http::withToken(config('services.temp_number.key')) ->acceptJson() ->withHeaders(['Idempotency-Key' => (string) Str::uuid()]) ->timeout(60) ->post('https://api.temp-number.com/v1/numbers/1482/cancel'); $result = $response->json();
प्रमाणीकरण
हर अनुरोध पर अपनी API कुंजी मानक Authorization हेडर में भेजें:
Authorization: Bearer YOUR_API_KEY
- API Access में कुंजियाँ बनाएँ। बनाते समय कुंजी पूरी केवल एक बार दिखाई जाती है।
- हर इंटीग्रेशन के लिए अलग key इस्तेमाल करें, ताकि एक को रद्द करने पर बाकी न टूटें। पासवर्ड बदलने पर सभी keys रद्द हो जाती हैं।
- गायब, गलत फ़ॉर्मैट वाली या रद्द की गई कुंजी पर
401मिलता है। जिस खाते ने अपना ईमेल सत्यापित नहीं किया है, या जो निलंबित है, उस पर403मिलता है,codeemail_unverifiedयाaccount_suspendedके साथ। - REST कुंजियाँ केवल
/v1पर काम करती हैं। MCP सर्वर अपना साइन-इन या MCP कुंजियाँ इस्तेमाल करता है - MCP सर्वर देखें।
बेस URL और वर्ज़निंग
सभी एंडपॉइंट स्थायी /v1 प्रीफ़िक्स के तहत हैं:
https://api.temp-number.com/v1
जोड़ने वाले बदलाव - नए फ़ील्ड, एंडपॉइंट या वैकल्पिक पैरामीटर - बिना वर्ज़न बदले जारी होते हैं, इसलिए जिन फ़ील्ड को आप नहीं जानते उन्हें अनदेखा करें। कोई ब्रेकिंग बदलाव /v2 के तहत जारी होगा; आपका इंटीग्रेशन कभी चुपचाप नहीं बदला जाता। मशीन-पठनीय अनुबंध OpenAPI spec है।
अनुरोध और जवाब
- हर अनुरोध पर JSON बॉडी
Content-Type: application/jsonके साथ भेजें, औरAccept: application/jsonभी भेजें। - सफलता:
{ "success": true, "data": …, "meta": {…} }।metaमें गिनती, पेजिनेशन और राशि का सारांश होता है। - त्रुटियाँ:
{ "success": false, "message": "…", "code": "…" }।codeके आधार पर ब्रांच करें; संदेश लोगों के पढ़ने के लिए है। त्रुटियाँ देखें। - समय ISO 8601 में होते हैं। राशि दो दशमलव वाले USD में होती है - हमेशा वही कीमत जो आप चुकाते हैं।
- कुछ ऑब्जेक्ट में मौजूदा इंटीग्रेशन के लिए अब भी पुराने फ़ील्ड नाम हैं (रेफ़रेंस में deprecated चिह्नित)। नए कोड को इन्हें अनदेखा करना चाहिए।
त्रुटियाँ
त्रुटियाँ मानक HTTP स्टेटस कोड इस्तेमाल करती हैं। बिज़नेस त्रुटियों में एक स्थिर, मशीन-पठनीय code होता है; कुछ में अधिक संदर्भ के साथ details भी होता है।
{
"success": false,
"message": "Insufficient wallet balance.",
"code": "insufficient_funds"
}
{
"message": "The country code field is required.",
"errors": {
"country_code": ["The country code field is required."]
}
}
| स्थिति | code | अर्थ | क्या करें |
|---|---|---|---|
| 400 | - | buy, renew या cancel पर Idempotency-Key हेडर नहीं है या गलत फ़ॉर्मैट में है। Body: {"error": "Missing Idempotency-Key header."} | Idempotency-Key में एक UUID भेजें। |
| 401 | - | कोई bearer टोकन नहीं, गलत फ़ॉर्मैट वाला टोकन, या रद्द की गई कुंजी। | Authorization हेडर जाँचें; अगर कुंजी रद्द की गई हो तो नई कुंजी बनाएँ। |
| 403 | email_unverified |
अकाउंट ने अभी तक अपना ईमेल पता सत्यापित नहीं किया है। | वेबसाइट पर ईमेल सत्यापित करें, फिर दोबारा प्रयास करें। |
| 403 | account_suspended |
अकाउंट निलंबित है। | सपोर्ट से संपर्क करें। |
| 403 | kyc_required |
नए नंबर खरीदने से पहले अकाउंट को अपनी पहचान सत्यापित करनी होगी। कोई शुल्क नहीं लिया गया; रिन्यूअल अब भी काम करते हैं। | अकाउंट सेटिंग्स में पहचान सत्यापन पूरा करें, फिर दोबारा प्रयास करें। |
| 403 | - | कुंजी के पास API एक्सेस नहीं है (उदाहरण के लिए MCP कुंजी), या GET /receive-sms से किसी दूसरे अकाउंट के नंबर के बारे में पूछा गया। | REST API कुंजी का उपयोग करें; केवल अपने नंबरों के बारे में पूछें। |
| 404 | - | नंबर, संदेश या देश आपके अकाउंट में नहीं है या अभी बिक्री पर नहीं है। दूसरे अकाउंट की id पर भी 404 मिलता है। | GET /numbers या GET /pricing से फिर से सूची लें। |
| 404 | private_email_closed |
प्राइवेट इनबॉक्स बंद है क्योंकि इसका नंबर रद्द या रिफ़ंड कर दिया गया था। | दोबारा प्रयास करने के लिए कुछ नहीं है। |
| 409 | - | यह Idempotency-Key पहले ही किसी दूसरी body के साथ उपयोग हो चुकी है, या इसके साथ भेजा गया पहला अनुरोध अभी भी चल रहा है। | नए अनुरोध के लिए नई कुंजी का उपयोग करें; चल रहे अनुरोध के लिए प्रतीक्षा करें और फिर से प्रयास करें। |
| 422 | insufficient_funds |
वॉलेट में कीमत चुकाने के लिए पर्याप्त राशि नहीं है। | वॉलेट टॉप अप करें और फिर से प्रयास करें। |
| 422 | out_of_stock |
आपकी कीमत जाँच और खरीदारी के बीच बाज़ार में स्टॉक खत्म हो गया। | GET /inventory फिर से जाँचें और कोई दूसरी अवधि या प्रकार चुनें। |
| 422 | invalid_duration |
उस देश और नंबर प्रकार के लिए यह अवधि उपलब्ध नहीं है। | GET /pricing/{countryCode} फिर से लाएँ। |
| 422 | - | सत्यापन विफल रहा (एक `errors` ऑब्जेक्ट हर फ़ील्ड का नाम बताता है) या किसी नियम ने कार्रवाई अस्वीकार कर दी, जैसे रिफ़ंड अवधि के बाहर रद्द करना। | `message` पढ़ें; दोबारा प्रयास करने के बजाय अनुरोध ठीक करें। |
| 429 | - | रेट लिमिट पूरी हो गई। | Retry-After हेडर की प्रतीक्षा करें, फिर बैकऑफ़ के साथ दोबारा प्रयास करें। |
| 503 | purchases_paused |
पूरे प्लेटफ़ॉर्म पर नई खरीदारी रोक दी गई है। कोई शुल्क नहीं लिया गया; रिन्यूअल और रद्द करना अब भी काम करते हैं। | Retry-After (60 s) के बाद फिर से प्रयास करें। |
| 5xx | - | हमारी ओर से कुछ गड़बड़ हो गई। | उसी Idempotency-Key के साथ फिर से प्रयास करें - आपसे कभी दो बार शुल्क नहीं लिया जाएगा। |
रेट लिमिट
सीमाएँ हर कुंजी पर लागू होती हैं, और पैसे से जुड़ी कॉल पर इसके अलावा प्रति खाता एक सख्त सीमा होती है:
| इस पर लागू | सीमा | गिनती |
|---|---|---|
| सभी एंडपॉइंट | 60 / मिनट | हर API key पर |
| खरीदें, रिन्यू करें, रद्द करें | 10 / मिनट | हर अकाउंट पर, ऊपर दी गई सीमाओं के अलावा |
| GET /receive-sms | 60 / मिनट | हर API key पर |
| GET /receive-sms | 30 / मिनट | हर API key और फ़ोन नंबर पर |
| GET /receive-sms | 30 / मिनट | हर IP पते पर |
सीमा पार करने पर आपको 429 के साथ एक Retry-After हेडर (सेकंड में) मिलता है। कम से कम उतनी देर प्रतीक्षा करें, फिर jitter के साथ बैक ऑफ़ करें। जवाबों में X-RateLimit-Limit और X-RateLimit-Remaining भी होते हैं।
Idempotency
POST /numbers/buy, /renew और /cancel के लिए ज़रूरी है एक Idempotency-Key हेडर: हर नई कार्रवाई के लिए आपके द्वारा बनाया गया एक UUID। अगर नेटवर्क टूट जाए, तो वही अनुरोध उसी कुंजी के साथ भेजें - आपको मूल जवाब वापस मिलेगा (X-Idempotency-Replayed: true चिह्नित) और आपसे कभी दो बार शुल्क नहीं लिया जाएगा।
- कुंजी न होने पर:
400। कुंजियाँ अधिकतम 128 वर्णों की होती हैं, जिनमें अक्षर, अंक और- _ . :हो सकते हैं - उसी कुंजी के साथ अलग बॉडी:
409। पहला अनुरोध चलते समय उसी कुंजी का उपयोग:409- थोड़ा रुकें और फिर से कोशिश करें। - कुंजियाँ हर खाते और एंडपॉइंट के लिए याद रखी जाती हैं। किसी दूसरी खरीदारी के लिए एक ही कुंजी दोबारा इस्तेमाल न करें।
पेजिनेशन
GET /receive-sms cursor पेजिनेशन इस्तेमाल करता है, सबसे नए पहले। meta.hasMore पढ़ें; जब तक यह true है, meta.nextCursor को cursor के रूप में, उसी phoneNumber के साथ, वापस भेजें। Cursor अपारदर्शी होते हैं - इन्हें न बनाएँ, न बदलें।
GET https://api.temp-number.com/v1/receive-sms?phoneNumber=%2B14035551234&limit=50&cursor=eyJkYXRlIjoiMjAyNi0wNS0xMyJ9
स्वभाव से छोटी सूचियाँ (/numbers, /pricing) सब कुछ एक ही जवाब में लौटाती हैं; निजी इनबॉक्स page और per_page इस्तेमाल करता है।
स्वीकार्य उपयोग
यह API डेवलपर्स के लिए बनाया गया है: वेरिफ़िकेशन और OTP फ़्लो, ऑटोमेटेड ऑनबोर्डिंग, QA और सिस्टम टेस्टिंग, और कोई भी प्रोडक्ट जिसे बड़े पैमाने पर इनबाउंड SMS या फ़ोन नंबर चाहिए।
- इसका उपयोग केवल वैध वेरिफ़िकेशन, डेवलपमेंट और टेस्टिंग के लिए करें।
- कोई स्कैम, स्पैम, धोखाधड़ी या छल नहीं। स्कैम या अन्य दुरुपयोग के लिए इस्तेमाल किए गए नंबरों पर खाते को तुरंत और बिना सूचना के बैन कर दिया जाता है, संबंधित नंबर रद्द कर दिए जाते हैं, और कोई रिफ़ंड नहीं मिलता।
- विनियमित या पहचान से जुड़े खातों के लिए नहीं। हमारे साझा, अस्थायी नंबर बैंकिंग, भुगतान, क्रिप्टोकरेंसी, सरकारी या ऐसी अन्य सेवाओं के SMS वेरिफ़िकेशन को सपोर्ट नहीं करते जो आपकी कानूनी पहचान सत्यापित करती हैं (KYC/AML) - उनके लिए अपना निजी मोबाइल नंबर इस्तेमाल करें।
API रेफ़रेंस
हर लाइव /v1 एंडपॉइंट। अनुरोध दाईं ओर आपकी भाषा में हैं; जवाब असली संरचना में हैं।
अकाउंट
अपना वॉलेट बैलेंस और सेटलमेंट मुद्रा देखें।
/v1/account
अकाउंट बैलेंस पाएँ
उपलब्ध वॉलेट बैलेंस और उसकी मुद्रा लौटाता है। खरीदारी से पहले इसे जाँचें ताकि आप साफ़ "टॉप अप करें" संदेश के साथ पहले ही रुक सकें।
रिस्पॉन्स फ़ील्ड-
balancenumberउपलब्ध वॉलेट बैलेंस।
-
currencystringसेटलमेंट मुद्रा, USD.
- 401कुंजी नहीं है या अमान्य है।
curl --request GET "https://api.temp-number.com/v1/account" \
--header "Authorization: Bearer $TEMP_NUMBER_API_KEY" \
--header "Accept: application/json"
const response = await fetch("https://api.temp-number.com/v1/account", {
headers: {
Authorization: `Bearer ${process.env.TEMP_NUMBER_API_KEY}`,
Accept: "application/json",
},
});
const result = await response.json();
console.log(response.status, result);
import os
import requests
response = requests.get(
"https://api.temp-number.com/v1/account",
headers={
"Authorization": f"Bearer {os.environ['TEMP_NUMBER_API_KEY']}",
"Accept": "application/json",
},
timeout=30,
)
print(response.status_code, response.json())
use Illuminate\Support\Facades\Http;
// config/services.php: 'temp_number' => ['key' => env('TEMP_NUMBER_API_KEY')]
$response = Http::withToken(config('services.temp_number.key'))
->acceptJson()
->get('https://api.temp-number.com/v1/account');
$result = $response->json();
{
"success": true,
"balance": 124.50,
"currency": "USD"
}
कीमतें और स्टॉक
लाइव बाज़ार, हर अवधि के लिए आपकी चुकाई जाने वाली सटीक कीमत और रियल-टाइम स्टॉक देखें।
देश का मूल्य ऑब्जेक्ट
एक देश और वहाँ खरीदे जा सकने वाले सभी पैकेज। price वह अंतिम राशि है जो आपके वॉलेट से ली जाती है; अपस्ट्रीम लागत कभी नहीं दिखाई जाती।
फ़ील्ड-
country_codestringISO 3166-1 alpha-2 कोड, जैसे US.
-
country_namestringप्रदर्शित नाम।
-
packages[].number_typeenumvoip या non_voip।
-
packages[].durationenumखरीदने के लिए भेजी जाने वाली कुंजी: halfDay, oneDay, oneWeek, oneMonth, threeMonths, sixMonths या oneYear. हर देश के अपने विकल्प होते हैं।
-
packages[].duration_labelstringपढ़ने योग्य लेबल, जैसे "1 महीना"।
-
packages[].pricenumberUSD में अंतिम कीमत।
-
packages[].original_pricenumber | nullछूट से पहले की कीमत, जब छूट लागू हो।
-
packages[].updated_atnullआरक्षित।
{
"country_code": "US",
"country_name": "United States",
"packages": [
{
"number_type": "voip",
"duration": "oneMonth",
"duration_label": "1 Month",
"price": 4.99,
"original_price": 5.99,
"updated_at": null
}
]
}
/v1/pricing
सभी देशों की कीमतें
पूरा लाइव कैटलॉग: देश के मूल्य ऑब्जेक्ट की सूची। price फ़ील्ड USD में उपयोगकर्ता के लिए अंतिम दर है, ठीक वही जो आपके वॉलेट से लिया जाता है।
लौटाता हैdata में देश के मूल्य ऑब्जेक्ट की सूची, साथ में meta.count।
त्रुटियाँ- 401कुंजी नहीं है या अमान्य है।
curl --request GET "https://api.temp-number.com/v1/pricing" \
--header "Authorization: Bearer $TEMP_NUMBER_API_KEY" \
--header "Accept: application/json"
const response = await fetch("https://api.temp-number.com/v1/pricing", {
headers: {
Authorization: `Bearer ${process.env.TEMP_NUMBER_API_KEY}`,
Accept: "application/json",
},
});
const result = await response.json();
console.log(response.status, result);
import os
import requests
response = requests.get(
"https://api.temp-number.com/v1/pricing",
headers={
"Authorization": f"Bearer {os.environ['TEMP_NUMBER_API_KEY']}",
"Accept": "application/json",
},
timeout=30,
)
print(response.status_code, response.json())
use Illuminate\Support\Facades\Http;
// config/services.php: 'temp_number' => ['key' => env('TEMP_NUMBER_API_KEY')]
$response = Http::withToken(config('services.temp_number.key'))
->acceptJson()
->get('https://api.temp-number.com/v1/pricing');
$result = $response->json();
{
"success": true,
"data": [
{
"country_code": "US",
"country_name": "United States",
"packages": [
{
"number_type": "voip",
"duration": "oneMonth",
"duration_label": "1 Month",
"price": 4.99,
"original_price": 5.99,
"updated_at": null
},
{
"number_type": "voip",
"duration": "threeMonths",
"duration_label": "3 Months",
"price": 12.99,
"original_price": null,
"updated_at": null
}
]
}
],
"meta": { "count": 1 }
}
/v1/pricing/{countryCode}
एक देश की कीमतें पाएँ
किसी एक देश की लाइव कीमतें। 404 का मतलब है कि उस देश के लिए अभी कोई सक्रिय रूट नहीं है: इसे अस्थायी "स्टॉक खत्म" मानें, "कभी नहीं बिकता" नहीं।
पैरामीटर-
countryCodestring path ज़रूरीISO 3166-1 alpha-2 देश कोड, जैसे US, GB, CA.
data में देश का एक मूल्य ऑब्जेक्ट।
त्रुटियाँ- 404उस देश के लिए अभी कोई सक्रिय रूट नहीं है।
curl --request GET "https://api.temp-number.com/v1/pricing/GB" \
--header "Authorization: Bearer $TEMP_NUMBER_API_KEY" \
--header "Accept: application/json"
const response = await fetch("https://api.temp-number.com/v1/pricing/GB", {
headers: {
Authorization: `Bearer ${process.env.TEMP_NUMBER_API_KEY}`,
Accept: "application/json",
},
});
const result = await response.json();
console.log(response.status, result);
import os
import requests
response = requests.get(
"https://api.temp-number.com/v1/pricing/GB",
headers={
"Authorization": f"Bearer {os.environ['TEMP_NUMBER_API_KEY']}",
"Accept": "application/json",
},
timeout=30,
)
print(response.status_code, response.json())
use Illuminate\Support\Facades\Http;
// config/services.php: 'temp_number' => ['key' => env('TEMP_NUMBER_API_KEY')]
$response = Http::withToken(config('services.temp_number.key'))
->acceptJson()
->get('https://api.temp-number.com/v1/pricing/GB');
$result = $response->json();
{
"success": true,
"data": {
"country_code": "GB",
"country_name": "United Kingdom",
"packages": [
{
"number_type": "voip",
"duration": "oneMonth",
"duration_label": "1 Month",
"price": 5.49,
"original_price": null,
"updated_at": null
}
]
}
}
/v1/inventory
स्टॉक जाँचें
किसी देश और अवधि का रियल-टाइम स्टॉक, ताकि आप किसी के क्लिक करने से पहले ही खरीदें बटन बंद कर सकें। types[] में सभी प्रकार साथ-साथ पाने के लिए number_type छोड़ दें। हरा परिणाम एक मज़बूत संकेत है, लेकिन अंतिम जाँच खरीदारी ही है।
पैरामीटर-
country_codestring query ज़रूरीISO 3166-1 alpha-2 देश कोड।
-
durationenum query वैकल्पिकGET /pricing/{countryCode} से एक अवधि कुंजी। रूट के डिफ़ॉल्ट के लिए इसे छोड़ दें।
इनमें से एकhalfDayoneDayoneWeekoneMonththreeMonthssixMonthsoneYear -
number_typeenum query वैकल्पिकजाँच को एक प्रकार तक सीमित करें। सभी प्रकार देखने के लिए इसे छोड़ दें।
इनमें से एकvoipnon_voip
-
stockinteger | nullउपलब्ध नंबर (number_type न देने पर types[] का कुल योग)।
-
availablebooleantrue, जब कम से कम एक नंबर खरीदा जा सकता हो।
-
statusstringपढ़ने योग्य लेबल: स्टॉक में, स्टॉक खत्म, जल्द आ रहा है…
-
types[]arrayकेवल तब जब number_type छोड़ा गया हो: बाज़ार में बिकने वाले हर प्रकार के लिए number_type, stock, available, status.
- 422इस चयन के लिए कुछ भी बिक्री पर नहीं है; details में स्टॉक फ़ील्ड होते हैं।
curl --request GET "https://api.temp-number.com/v1/inventory?country_code=US&duration=oneMonth" \
--header "Authorization: Bearer $TEMP_NUMBER_API_KEY" \
--header "Accept: application/json"
const response = await fetch("https://api.temp-number.com/v1/inventory?country_code=US&duration=oneMonth", {
headers: {
Authorization: `Bearer ${process.env.TEMP_NUMBER_API_KEY}`,
Accept: "application/json",
},
});
const result = await response.json();
console.log(response.status, result);
import os
import requests
response = requests.get(
"https://api.temp-number.com/v1/inventory",
headers={
"Authorization": f"Bearer {os.environ['TEMP_NUMBER_API_KEY']}",
"Accept": "application/json",
},
params={"country_code": "US", "duration": "oneMonth"},
timeout=30,
)
print(response.status_code, response.json())
use Illuminate\Support\Facades\Http;
// config/services.php: 'temp_number' => ['key' => env('TEMP_NUMBER_API_KEY')]
$response = Http::withToken(config('services.temp_number.key'))
->acceptJson()
->get('https://api.temp-number.com/v1/inventory', [
'country_code' => 'US',
'duration' => 'oneMonth',
]);
$result = $response->json();
{
"success": true,
"data": {
"country_code": "US",
"duration": "oneMonth",
"number_type": null,
"stock": 47,
"available": true,
"status": "In Stock",
"types": [
{ "number_type": "voip", "stock": 0, "available": false, "status": "Out of Stock" },
{ "number_type": "non_voip", "stock": 47, "available": true, "status": "In Stock" }
]
}
}
नंबर
अपने प्राइवेट नंबरों की सूची देखें, उन्हें खरीदें, रिन्यू करें और रद्द करें। पैसों से जुड़ी कॉल idempotent हैं और दोबारा भेजने पर सुरक्षित हैं।
नंबर ऑब्जेक्ट
आपके अकाउंट का एक नंबर। खरीदना, रिन्यू करना और रद्द करना meta में पैसों का सारांश भी लौटाते हैं: charged (या refunded), currency और wallet_balance_after।
फ़ील्ड-
idintegerइसे /numbers/{id}/… कॉल में उपयोग करें। Webhook इसे number.rentalId के रूप में भेजते हैं।
-
phone_numberstringE.164, जैसे +14035551234.
-
country_codestring | nullISO 3166-1 alpha-2.
-
country_namestringप्रदर्शित नाम।
-
number_typeenumvoip या non_voip।
-
statusenumactive, expired, cancelled या refunded।
-
purchase_datestringISO 8601, UTC.
-
expire_datestringISO 8601, UTC. इसके बाद नंबर पर SMS आना बंद हो जाता है और इसे रिन्यू नहीं किया जा सकता।
पुराने इंटीग्रेशन के लिए अब भी भेजे जाने वाले अप्रचलित उपनाम: country, provider, purchased_at और expires_at (epoch मिलीसेकंड)। इन पर निर्भर न रहें।
{
"id": 1482,
"phone_number": "+14035551234",
"country_code": "US",
"country_name": "United States",
"number_type": "voip",
"status": "active",
"purchase_date": "2026-05-13T17:42:09Z",
"expire_date": "2026-06-13T17:42:09Z"
}
/v1/numbers
अपने नंबरों की सूची
आपके अकाउंट के सभी नंबर, सबसे नए पहले। रिन्यूअल रिमाइंडर के लिए status=expiring_soon (समाप्ति से 10 दिन के भीतर वाले सक्रिय नंबर) का उपयोग करें।
पैरामीटर-
statusenum query वैकल्पिकजीवनचक्र फ़िल्टर। डिफ़ॉल्ट all.
इनमें से एकallactiveexpiring_soonexpiredcancelled
data में नंबर ऑब्जेक्ट की सूची; meta.count और meta.status।
त्रुटियाँ- 401कुंजी नहीं है या अमान्य है।
curl --request GET "https://api.temp-number.com/v1/numbers?status=expiring_soon" \
--header "Authorization: Bearer $TEMP_NUMBER_API_KEY" \
--header "Accept: application/json"
const response = await fetch("https://api.temp-number.com/v1/numbers?status=expiring_soon", {
headers: {
Authorization: `Bearer ${process.env.TEMP_NUMBER_API_KEY}`,
Accept: "application/json",
},
});
const result = await response.json();
console.log(response.status, result);
import os
import requests
response = requests.get(
"https://api.temp-number.com/v1/numbers",
headers={
"Authorization": f"Bearer {os.environ['TEMP_NUMBER_API_KEY']}",
"Accept": "application/json",
},
params={"status": "expiring_soon"},
timeout=30,
)
print(response.status_code, response.json())
use Illuminate\Support\Facades\Http;
// config/services.php: 'temp_number' => ['key' => env('TEMP_NUMBER_API_KEY')]
$response = Http::withToken(config('services.temp_number.key'))
->acceptJson()
->get('https://api.temp-number.com/v1/numbers', [
'status' => 'expiring_soon',
]);
$result = $response->json();
{
"success": true,
"data": [
{
"id": 1482,
"phone_number": "+14035551234",
"country_code": "US",
"country_name": "United States",
"number_type": "voip",
"status": "active",
"purchase_date": "2026-05-13T17:42:09Z",
"expire_date": "2026-06-13T17:42:09Z"
}
],
"meta": { "count": 1, "status": "expiring_soon" }
}
/v1/numbers/buy
Idempotency-Key ज़रूरी है नंबर खरीदें
एक नया प्राइवेट नंबर आवंटित करता है और एक ही अटॉमिक चरण में आपके वॉलेट से शुल्क लेता है। अगर शुल्क लेने के बाद डिलीवरी विफल हो जाए, तो शुल्क वापस कर दिया जाता है: ऐसा कभी नहीं होगा कि आपने भुगतान किया और नंबर नहीं मिला। जवाब में लिया गया शुल्क और बाद का बैलेंस दिखाया जाता है।
पैरामीटर-
country_codestring body ज़रूरीGET /pricing से कोई देश।
-
durationenum body ज़रूरीउस देश के packages[] से एक अवधि कुंजी - हर देश के अपने विकल्प होते हैं।
इनमें से एकhalfDayoneDayoneWeekoneMonththreeMonthssixMonthsoneYear -
number_typeenum body वैकल्पिकरूट के डिफ़ॉल्ट का उपयोग करने के लिए इसे छोड़ दें।
इनमें से एकvoipnon_voip -
Idempotency-Keystring header ज़रूरीएक UUID, हर खरीदारी के लिए नया, दोबारा प्रयास करने पर वही।
data में नया नंबर ऑब्जेक्ट; meta.charged, meta.currency, meta.wallet_balance_after.
त्रुटियाँ- 422
insufficient_fundsवॉलेट में कीमत चुकाने के लिए पर्याप्त राशि नहीं है। - 422
out_of_stockआपकी स्टॉक जाँच के बाद स्टॉक खत्म हो गया। - 422
invalid_durationइस देश/प्रकार के लिए यह अवधि उपलब्ध नहीं है। - 403
kyc_requiredपहले पहचान सत्यापन ज़रूरी है। कोई शुल्क नहीं लिया गया। - 503
purchases_pausedपूरे प्लेटफ़ॉर्म पर खरीदारी रोकी गई है। Retry-After: 60.
curl --request POST "https://api.temp-number.com/v1/numbers/buy" \
--header "Authorization: Bearer $TEMP_NUMBER_API_KEY" \
--header "Accept: application/json" \
--header "Content-Type: application/json" \
--header "Idempotency-Key: $(uuidgen)" \
--data '{"country_code":"US","duration":"oneMonth","number_type":"voip"}'
import { randomUUID } from "node:crypto";
const response = await fetch("https://api.temp-number.com/v1/numbers/buy", {
method: "POST",
headers: {
Authorization: `Bearer ${process.env.TEMP_NUMBER_API_KEY}`,
Accept: "application/json",
"Content-Type": "application/json",
"Idempotency-Key": randomUUID(),
},
body: JSON.stringify({ country_code: "US", duration: "oneMonth", number_type: "voip" }),
});
const result = await response.json();
console.log(response.status, result);
import os
import uuid
import requests
response = requests.post(
"https://api.temp-number.com/v1/numbers/buy",
headers={
"Authorization": f"Bearer {os.environ['TEMP_NUMBER_API_KEY']}",
"Accept": "application/json",
"Idempotency-Key": str(uuid.uuid4()),
},
json={"country_code": "US", "duration": "oneMonth", "number_type": "voip"},
timeout=60,
)
print(response.status_code, response.json())
use Illuminate\Support\Facades\Http;
use Illuminate\Support\Str;
// config/services.php: 'temp_number' => ['key' => env('TEMP_NUMBER_API_KEY')]
$response = Http::withToken(config('services.temp_number.key'))
->acceptJson()
->withHeaders(['Idempotency-Key' => (string) Str::uuid()])
->timeout(60)
->post('https://api.temp-number.com/v1/numbers/buy', [
'country_code' => 'US',
'duration' => 'oneMonth',
'number_type' => 'voip',
]);
$result = $response->json();
{
"success": true,
"data": {
"id": 1482,
"phone_number": "+14035551234",
"country_code": "US",
"country_name": "United States",
"number_type": "voip",
"status": "active",
"purchase_date": "2026-05-13T17:42:09Z",
"expire_date": "2026-06-13T17:42:09Z"
},
"meta": {
"charged": 4.99,
"currency": "USD",
"wallet_balance_after": 119.51
}
}
/v1/numbers/{id}/renew
Idempotency-Key ज़रूरी है नंबर रिन्यू करें
चुने गए पैकेज के अनुसार नंबर की अवधि बढ़ाता है। नई अवधि मौजूदा समाप्ति तिथि में जोड़ी जाती है, इसलिए जल्दी रिन्यू करने में कुछ नहीं खोता। कीमत साइट की मौजूदा दर है, जिसकी गणना हमारी ओर से होती है। समाप्त हो चुके नंबर रिन्यू नहीं किए जा सकते: नया नंबर खरीदें।
पैरामीटर-
idinteger path ज़रूरीGET /numbers से नंबर id।
-
packageenum body वैकल्पिकरिन्यूअल की अवधि। डिफ़ॉल्ट oneMonth. (duration को पुराने उपनाम के रूप में स्वीकार किया जाता है।)
इनमें से एकoneMonththreeMonthssixMonthsoneYear -
Idempotency-Keystring header ज़रूरीएक UUID, हर रिन्यूअल के लिए नया, दोबारा प्रयास करने पर वही।
data में अपडेट किया गया नंबर ऑब्जेक्ट; meta.charged, meta.currency, meta.wallet_balance_after.
त्रुटियाँ- 404यह नंबर आपके अकाउंट में नहीं है।
- 422
insufficient_fundsवॉलेट में रिन्यूअल के लिए पर्याप्त राशि नहीं है। - 422समाप्त, रद्द या रिन्यू के योग्य नहीं।
curl --request POST "https://api.temp-number.com/v1/numbers/1482/renew" \
--header "Authorization: Bearer $TEMP_NUMBER_API_KEY" \
--header "Accept: application/json" \
--header "Content-Type: application/json" \
--header "Idempotency-Key: $(uuidgen)" \
--data '{"package":"threeMonths"}'
import { randomUUID } from "node:crypto";
const response = await fetch("https://api.temp-number.com/v1/numbers/1482/renew", {
method: "POST",
headers: {
Authorization: `Bearer ${process.env.TEMP_NUMBER_API_KEY}`,
Accept: "application/json",
"Content-Type": "application/json",
"Idempotency-Key": randomUUID(),
},
body: JSON.stringify({ package: "threeMonths" }),
});
const result = await response.json();
console.log(response.status, result);
import os
import uuid
import requests
response = requests.post(
"https://api.temp-number.com/v1/numbers/1482/renew",
headers={
"Authorization": f"Bearer {os.environ['TEMP_NUMBER_API_KEY']}",
"Accept": "application/json",
"Idempotency-Key": str(uuid.uuid4()),
},
json={"package": "threeMonths"},
timeout=60,
)
print(response.status_code, response.json())
use Illuminate\Support\Facades\Http;
use Illuminate\Support\Str;
// config/services.php: 'temp_number' => ['key' => env('TEMP_NUMBER_API_KEY')]
$response = Http::withToken(config('services.temp_number.key'))
->acceptJson()
->withHeaders(['Idempotency-Key' => (string) Str::uuid()])
->timeout(60)
->post('https://api.temp-number.com/v1/numbers/1482/renew', [
'package' => 'threeMonths',
]);
$result = $response->json();
{
"success": true,
"data": {
"id": 1482,
"phone_number": "+14035551234",
"country_code": "US",
"country_name": "United States",
"number_type": "voip",
"status": "active",
"purchase_date": "2026-05-13T17:42:09Z",
"expire_date": "2026-09-13T17:42:09Z"
},
"meta": {
"charged": 12.99,
"currency": "USD",
"wallet_balance_after": 106.52
}
}
/v1/numbers/{id}/cancel
Idempotency-Key ज़रूरी है रिफ़ंड के लिए नंबर रद्द करें
नंबर को छोड़ता है और उसकी पूरी कीमत आपके वॉलेट में रिफ़ंड करता है। यह केवल खरीद के 15 से 120 मिनट के बीच, नंबर सक्रिय रहते हुए और उस पर कोई SMS आने से पहले संभव है। इन नियमों के बाहर कॉल 422 के साथ अस्वीकार हो जाती है और कुछ नहीं बदलता; बहुत जल्दी होने पर details.seconds_until_open बताता है कि कितनी प्रतीक्षा करनी है।
पैरामीटर-
idinteger path ज़रूरीGET /numbers से नंबर id।
-
Idempotency-Keystring header ज़रूरीएक UUID, दोबारा प्रयास करने पर वही।
data में नंबर ऑब्जेक्ट (status cancelled); meta.refunded, meta.currency, meta.wallet_balance_after.
त्रुटियाँ- 404यह नंबर आपके अकाउंट में नहीं है।
- 422बहुत जल्दी (15 मिनट से कम), बहुत देर (120 मिनट से अधिक), SMS पहले ही आ चुका है, या सक्रिय नहीं है।
curl --request POST "https://api.temp-number.com/v1/numbers/1482/cancel" \
--header "Authorization: Bearer $TEMP_NUMBER_API_KEY" \
--header "Accept: application/json" \
--header "Idempotency-Key: $(uuidgen)"
import { randomUUID } from "node:crypto";
const response = await fetch("https://api.temp-number.com/v1/numbers/1482/cancel", {
method: "POST",
headers: {
Authorization: `Bearer ${process.env.TEMP_NUMBER_API_KEY}`,
Accept: "application/json",
"Idempotency-Key": randomUUID(),
},
});
const result = await response.json();
console.log(response.status, result);
import os
import uuid
import requests
response = requests.post(
"https://api.temp-number.com/v1/numbers/1482/cancel",
headers={
"Authorization": f"Bearer {os.environ['TEMP_NUMBER_API_KEY']}",
"Accept": "application/json",
"Idempotency-Key": str(uuid.uuid4()),
},
timeout=60,
)
print(response.status_code, response.json())
use Illuminate\Support\Facades\Http;
use Illuminate\Support\Str;
// config/services.php: 'temp_number' => ['key' => env('TEMP_NUMBER_API_KEY')]
$response = Http::withToken(config('services.temp_number.key'))
->acceptJson()
->withHeaders(['Idempotency-Key' => (string) Str::uuid()])
->timeout(60)
->post('https://api.temp-number.com/v1/numbers/1482/cancel');
$result = $response->json();
{
"success": true,
"data": {
"id": 1482,
"phone_number": "+14035551234",
"country_code": "US",
"country_name": "United States",
"number_type": "voip",
"status": "cancelled",
"purchase_date": "2026-05-13T17:42:09Z",
"expire_date": "2026-06-13T17:42:09Z"
},
"meta": {
"refunded": 4.99,
"currency": "USD",
"wallet_balance_after": 124.50
}
}
SMS
अपने नंबरों पर आने वाले SMS पढ़ें। आपको मूल टेक्स्ट मिलता है; कोड निकालना आपके ऊपर है।
SMS संदेश ऑब्जेक्ट
एक प्राप्त SMS, जैसा GET /numbers/{id}/sms लौटाता है। (GET /receive-sms एक camelCase रूप का उपयोग करता है, जो उसी एंडपॉइंट पर दिखाया गया है।)
फ़ील्ड-
idintegerसंदेश id।
-
fromstringप्रेषक: कोई फ़ोन नंबर या WhatsApp जैसा कोई नाम।
-
bodystringसंदेश का पूरा टेक्स्ट।
-
received_atstringISO 8601, UTC.
अब भी भेजे जाने वाले अप्रचलित उपनाम: sender (= from) और message (= body)।
{
"id": 9912,
"from": "+18005550199",
"body": "Your code is 432901",
"received_at": "2026-05-13T17:43:14Z"
}
/v1/numbers/{id}/sms
नंबर और उसके SMS पाएँ
एक नंबर और उस पर आए सभी SMS, सबसे नए पहले। "इस नंबर का विवरण" दृश्य के लिए और कोड की प्रतीक्षा करते समय किसी एक नंबर को पोल करने के लिए सबसे अच्छा। जो id आपकी नहीं हैं उन पर 404 मिलता है।
पैरामीटर-
idinteger path ज़रूरीGET /numbers से नंबर id।
data.number (एक नंबर ऑब्जेक्ट) और data.messages (SMS मैसेज ऑब्जेक्ट); meta.count।
त्रुटियाँ- 404यह नंबर आपके अकाउंट में नहीं है।
curl --request GET "https://api.temp-number.com/v1/numbers/1482/sms" \
--header "Authorization: Bearer $TEMP_NUMBER_API_KEY" \
--header "Accept: application/json"
const response = await fetch("https://api.temp-number.com/v1/numbers/1482/sms", {
headers: {
Authorization: `Bearer ${process.env.TEMP_NUMBER_API_KEY}`,
Accept: "application/json",
},
});
const result = await response.json();
console.log(response.status, result);
import os
import requests
response = requests.get(
"https://api.temp-number.com/v1/numbers/1482/sms",
headers={
"Authorization": f"Bearer {os.environ['TEMP_NUMBER_API_KEY']}",
"Accept": "application/json",
},
timeout=30,
)
print(response.status_code, response.json())
use Illuminate\Support\Facades\Http;
// config/services.php: 'temp_number' => ['key' => env('TEMP_NUMBER_API_KEY')]
$response = Http::withToken(config('services.temp_number.key'))
->acceptJson()
->get('https://api.temp-number.com/v1/numbers/1482/sms');
$result = $response->json();
{
"success": true,
"data": {
"number": {
"id": 1482,
"phone_number": "+14035551234",
"country_code": "US",
"country_name": "United States",
"number_type": "voip",
"status": "active",
"purchase_date": "2026-05-13T17:42:09Z",
"expire_date": "2026-06-13T17:42:09Z"
},
"messages": [
{
"id": 9912,
"from": "+18005550199",
"body": "Your code is 432901",
"received_at": "2026-05-13T17:43:14Z"
}
]
},
"meta": { "count": 1 }
}
/v1/receive-sms
फ़ोन नंबर से SMS प्राप्त करें
आपके अपने किसी नंबर के SMS, कर्सर-आधारित पेजिनेशन के साथ, जिन्हें id के बजाय फ़ोन नंबर से पहचाना जाता है। ज़्यादा SMS वाले इनबॉक्स के लिए सबसे अच्छा। जो नंबर आपका नहीं है उस पर 403 मिलता है।
पैरामीटर-
phoneNumberstring query ज़रूरीE.164 या केवल अंक, जैसे +14035551234. + को URL-encode करें।
-
limitinteger query वैकल्पिकपेज का आकार 1-100. डिफ़ॉल्ट 50.
-
cursorstring query वैकल्पिकपिछले पेज से meta.nextCursor।
-
data.messages[].idintegerसंदेश id।
-
data.messages[].fromstringप्रेषक।
-
data.messages[].tostringआपका नंबर।
-
data.messages[].messagestringपूरा टेक्स्ट।
-
data.messages[].receivedAtstringISO 8601.
-
meta.hasMore / nextCursorboolean / string | nullअगले पेज के लिए nextCursor को cursor के रूप में भेजें।
- 403यह नंबर आपके अकाउंट में नहीं है।
- 422phoneNumber मौजूद नहीं है या अमान्य है।
curl --request GET "https://api.temp-number.com/v1/receive-sms?phoneNumber=%2B14035551234&limit=50" \
--header "Authorization: Bearer $TEMP_NUMBER_API_KEY" \
--header "Accept: application/json"
const response = await fetch("https://api.temp-number.com/v1/receive-sms?phoneNumber=%2B14035551234&limit=50", {
headers: {
Authorization: `Bearer ${process.env.TEMP_NUMBER_API_KEY}`,
Accept: "application/json",
},
});
const result = await response.json();
console.log(response.status, result);
import os
import requests
response = requests.get(
"https://api.temp-number.com/v1/receive-sms",
headers={
"Authorization": f"Bearer {os.environ['TEMP_NUMBER_API_KEY']}",
"Accept": "application/json",
},
params={"phoneNumber": "+14035551234", "limit": 50},
timeout=30,
)
print(response.status_code, response.json())
use Illuminate\Support\Facades\Http;
// config/services.php: 'temp_number' => ['key' => env('TEMP_NUMBER_API_KEY')]
$response = Http::withToken(config('services.temp_number.key'))
->acceptJson()
->get('https://api.temp-number.com/v1/receive-sms', [
'phoneNumber' => '+14035551234',
'limit' => 50,
]);
$result = $response->json();
{
"success": true,
"data": {
"phoneNumber": "+14035551234",
"purchaseStatus": "active",
"messages": [
{
"id": 1842,
"from": "WhatsApp",
"to": "+14035551234",
"message": "Your verification code is 483920.",
"receivedAt": "2026-05-13T17:43:14+00:00"
}
]
},
"meta": {
"count": 1,
"pageSize": 50,
"hasMore": false,
"nextCursor": null,
"prevCursor": null,
"requestedAt": "2026-05-13T17:43:20+00:00"
}
}
प्राइवेट ईमेल
हर प्राइवेट नंबर के लिए एक मुफ़्त, केवल-प्राप्ति वाला [email protected] इनबॉक्स। हर नंबर के लिए एक पता।
प्राइवेट ईमेल ऑब्जेक्ट
किसी एक नंबर से जुड़ा इनबॉक्स।
फ़ील्ड-
addressstring | nullपता, या पता लेने से पहले null.
-
statusenumactive या none।
-
unread_countintegerअपठित ईमेल।
-
created_atstring | nullजब पता लिया गया।
-
eligiblebooleantrue, जब नंबर अभी पता ले सकता हो।
-
linked_numberstringवह फ़ोन नंबर जिससे यह जुड़ा है।
-
domainstringprivnum.com
-
suggestionsstring[]योग्य होने पर नाम के सुझाव।
{
"address": "[email protected]",
"status": "active",
"unread_count": 2,
"created_at": "2026-07-03T10:15:00+00:00",
"eligible": false,
"linked_number": "+14035551234",
"domain": "privnum.com",
"suggestions": []
}
/v1/numbers/{id}/private-email
प्राइवेट ईमेल पाएँ
किसी नंबर का पता, या पता लेने से पहले, यह कि क्या उसे पता मिल सकता है और कुछ नाम सुझाव।
पैरामीटर-
idinteger path ज़रूरीGET /numbers से नंबर id।
data में एक प्राइवेट ईमेल ऑब्जेक्ट।
त्रुटियाँ- 404यह नंबर आपके अकाउंट में नहीं है।
curl --request GET "https://api.temp-number.com/v1/numbers/1482/private-email" \
--header "Authorization: Bearer $TEMP_NUMBER_API_KEY" \
--header "Accept: application/json"
const response = await fetch("https://api.temp-number.com/v1/numbers/1482/private-email", {
headers: {
Authorization: `Bearer ${process.env.TEMP_NUMBER_API_KEY}`,
Accept: "application/json",
},
});
const result = await response.json();
console.log(response.status, result);
import os
import requests
response = requests.get(
"https://api.temp-number.com/v1/numbers/1482/private-email",
headers={
"Authorization": f"Bearer {os.environ['TEMP_NUMBER_API_KEY']}",
"Accept": "application/json",
},
timeout=30,
)
print(response.status_code, response.json())
use Illuminate\Support\Facades\Http;
// config/services.php: 'temp_number' => ['key' => env('TEMP_NUMBER_API_KEY')]
$response = Http::withToken(config('services.temp_number.key'))
->acceptJson()
->get('https://api.temp-number.com/v1/numbers/1482/private-email');
$result = $response->json();
{
"success": true,
"data": {
"address": null,
"status": "none",
"unread_count": 0,
"created_at": null,
"eligible": true,
"linked_number": "+14035551234",
"domain": "privnum.com",
"suggestions": ["alex.smith", "alex.smith42"]
}
}
/v1/numbers/{id}/private-email/availability
नाम जाँचें
नाम लेने से पहले लाइव जाँचें कि वह मान्य और उपलब्ध है।
पैरामीटर-
idinteger path ज़रूरीGET /numbers से नंबर id।
-
local_partstring query ज़रूरी@ से पहले का भाग: 3-64 अक्षर, अंक, बिंदु, डैश या अंडरस्कोर।
-
availablebooleantrue, जब आप इसे ले सकते हों।
-
reasonenum | nulltoo_short, too_long, invalid, reserved या taken।
- 404यह नंबर आपके अकाउंट में नहीं है।
curl --request GET "https://api.temp-number.com/v1/numbers/1482/private-email/availability?local_part=alex.smith" \
--header "Authorization: Bearer $TEMP_NUMBER_API_KEY" \
--header "Accept: application/json"
const response = await fetch("https://api.temp-number.com/v1/numbers/1482/private-email/availability?local_part=alex.smith", {
headers: {
Authorization: `Bearer ${process.env.TEMP_NUMBER_API_KEY}`,
Accept: "application/json",
},
});
const result = await response.json();
console.log(response.status, result);
import os
import requests
response = requests.get(
"https://api.temp-number.com/v1/numbers/1482/private-email/availability",
headers={
"Authorization": f"Bearer {os.environ['TEMP_NUMBER_API_KEY']}",
"Accept": "application/json",
},
params={"local_part": "alex.smith"},
timeout=30,
)
print(response.status_code, response.json())
use Illuminate\Support\Facades\Http;
// config/services.php: 'temp_number' => ['key' => env('TEMP_NUMBER_API_KEY')]
$response = Http::withToken(config('services.temp_number.key'))
->acceptJson()
->get('https://api.temp-number.com/v1/numbers/1482/private-email/availability', [
'local_part' => 'alex.smith',
]);
$result = $response->json();
{
"success": true,
"data": {
"local_part": "alex.smith",
"address": "[email protected]",
"available": true,
"reason": null,
"message": "Available"
}
}
/v1/numbers/{id}/private-email
पता प्राप्त करें
सक्रिय नंबर को उसका पता देता है। मुफ़्त, हर नंबर के लिए एक, और लिया गया पता कभी किसी और को नहीं दिया जाता।
पैरामीटर-
idinteger path ज़रूरीGET /numbers से नंबर id।
-
local_partstring body ज़रूरीवह नाम जो आपने जाँचा।
data में प्राइवेट ईमेल ऑब्जेक्ट।
त्रुटियाँ- 404यह आपका नंबर नहीं है, या अभी इसका कोई पता नहीं है।
- 422नाम पहले से लिया गया या अमान्य है (details.reason), नंबर के पास पहले से पता है, या वह सक्रिय नहीं है।
curl --request POST "https://api.temp-number.com/v1/numbers/1482/private-email" \
--header "Authorization: Bearer $TEMP_NUMBER_API_KEY" \
--header "Accept: application/json" \
--header "Content-Type: application/json" \
--data '{"local_part":"alex.smith"}'
const response = await fetch("https://api.temp-number.com/v1/numbers/1482/private-email", {
method: "POST",
headers: {
Authorization: `Bearer ${process.env.TEMP_NUMBER_API_KEY}`,
Accept: "application/json",
"Content-Type": "application/json",
},
body: JSON.stringify({ local_part: "alex.smith" }),
});
const result = await response.json();
console.log(response.status, result);
import os
import requests
response = requests.post(
"https://api.temp-number.com/v1/numbers/1482/private-email",
headers={
"Authorization": f"Bearer {os.environ['TEMP_NUMBER_API_KEY']}",
"Accept": "application/json",
},
json={"local_part": "alex.smith"},
timeout=60,
)
print(response.status_code, response.json())
use Illuminate\Support\Facades\Http;
// config/services.php: 'temp_number' => ['key' => env('TEMP_NUMBER_API_KEY')]
$response = Http::withToken(config('services.temp_number.key'))
->acceptJson()
->timeout(60)
->post('https://api.temp-number.com/v1/numbers/1482/private-email', [
'local_part' => 'alex.smith',
]);
$result = $response->json();
{
"success": true,
"data": {
"address": "[email protected]",
"status": "active",
"unread_count": 0,
"created_at": "2026-07-03T10:15:00+00:00",
"eligible": false,
"linked_number": "+14035551234",
"domain": "privnum.com",
"suggestions": []
}
}
/v1/numbers/{id}/private-email/inbox
ईमेल की सूची
ईमेल सारांश, सबसे नए पहले, पेज-आधारित पेजिनेशन और शीर्ष स्तर पर अपठित संख्या के साथ।
पैरामीटर-
idinteger path ज़रूरीGET /numbers से नंबर id।
-
pageinteger query वैकल्पिकपेज नंबर। डिफ़ॉल्ट 1.
-
per_pageinteger query वैकल्पिक1-100. डिफ़ॉल्ट 25.
-
data[]arrayid, from_email, from_name, subject, preview, attachment_count, is_read, received_at।
-
metaobjectcurrent_page, per_page, total, last_page।
-
unread_countintegerशीर्ष स्तर पर, data के बगल में।
- 404यह आपका नंबर नहीं है, या अभी इसका कोई पता नहीं है।
- 404
private_email_closedनंबर रद्द या रिफ़ंड कर दिया गया था।
curl --request GET "https://api.temp-number.com/v1/numbers/1482/private-email/inbox?page=1&per_page=25" \
--header "Authorization: Bearer $TEMP_NUMBER_API_KEY" \
--header "Accept: application/json"
const response = await fetch("https://api.temp-number.com/v1/numbers/1482/private-email/inbox?page=1&per_page=25", {
headers: {
Authorization: `Bearer ${process.env.TEMP_NUMBER_API_KEY}`,
Accept: "application/json",
},
});
const result = await response.json();
console.log(response.status, result);
import os
import requests
response = requests.get(
"https://api.temp-number.com/v1/numbers/1482/private-email/inbox",
headers={
"Authorization": f"Bearer {os.environ['TEMP_NUMBER_API_KEY']}",
"Accept": "application/json",
},
params={"page": 1, "per_page": 25},
timeout=30,
)
print(response.status_code, response.json())
use Illuminate\Support\Facades\Http;
// config/services.php: 'temp_number' => ['key' => env('TEMP_NUMBER_API_KEY')]
$response = Http::withToken(config('services.temp_number.key'))
->acceptJson()
->get('https://api.temp-number.com/v1/numbers/1482/private-email/inbox', [
'page' => 1,
'per_page' => 25,
]);
$result = $response->json();
{
"success": true,
"data": [
{
"id": 77,
"from_email": "[email protected]",
"from_name": "Example Billing",
"subject": "Your receipt",
"preview": "Thanks for your order…",
"attachment_count": 1,
"is_read": false,
"received_at": "2026-07-04T08:01:12+00:00"
}
],
"meta": { "current_page": 1, "per_page": 25, "total": 1, "last_page": 1 },
"unread_count": 1
}
/v1/numbers/{id}/private-email/inbox/{messageId}/body
ईमेल पढ़ें
पूरा ईमेल (HTML और टेक्स्ट) उसके अटैचमेंट की सूची के साथ। इसे पढ़ने पर यह पढ़ा हुआ मार्क हो जाता है।
पैरामीटर-
idinteger path ज़रूरीGET /numbers से नंबर id।
-
messageIdinteger path ज़रूरीइनबॉक्स सूची से ईमेल id।
- 404यह आपका नंबर नहीं है, या अभी इसका कोई पता नहीं है।
- 404
private_email_closedनंबर रद्द या रिफ़ंड कर दिया गया था।
curl --request GET "https://api.temp-number.com/v1/numbers/1482/private-email/inbox/77/body" \
--header "Authorization: Bearer $TEMP_NUMBER_API_KEY" \
--header "Accept: application/json"
const response = await fetch("https://api.temp-number.com/v1/numbers/1482/private-email/inbox/77/body", {
headers: {
Authorization: `Bearer ${process.env.TEMP_NUMBER_API_KEY}`,
Accept: "application/json",
},
});
const result = await response.json();
console.log(response.status, result);
import os
import requests
response = requests.get(
"https://api.temp-number.com/v1/numbers/1482/private-email/inbox/77/body",
headers={
"Authorization": f"Bearer {os.environ['TEMP_NUMBER_API_KEY']}",
"Accept": "application/json",
},
timeout=30,
)
print(response.status_code, response.json())
use Illuminate\Support\Facades\Http;
// config/services.php: 'temp_number' => ['key' => env('TEMP_NUMBER_API_KEY')]
$response = Http::withToken(config('services.temp_number.key'))
->acceptJson()
->get('https://api.temp-number.com/v1/numbers/1482/private-email/inbox/77/body');
$result = $response->json();
{
"success": true,
"data": {
"id": 77,
"subject": "Your receipt",
"from_email": "[email protected]",
"from_name": "Example Billing",
"received_at": "2026-07-04T08:01:12+00:00",
"html": "<p>Thanks for your order…</p>",
"text": "Thanks for your order…",
"attachments": [
{ "index": 0, "filename": "receipt.pdf", "content_type": "application/pdf", "size_bytes": 48211 }
]
}
}
/v1/numbers/{id}/private-email/inbox/{messageId}/attachments/{index}
अटैचमेंट डाउनलोड करें
मूल फ़ाइल, अपने Content-Type और फ़ाइल नाम के साथ। index ईमेल के attachments[] से आता है।
पैरामीटर-
idinteger path ज़रूरीGET /numbers से नंबर id।
-
messageIdinteger path ज़रूरीइनबॉक्स सूची से ईमेल id।
-
indexinteger path ज़रूरी“ईमेल पढ़ें” से attachments[].index।
- 404यह आपका नंबर नहीं है, या अभी इसका कोई पता नहीं है।
- 404
private_email_closedनंबर रद्द या रिफ़ंड कर दिया गया था। - 404उस इंडेक्स पर कोई अटैचमेंट नहीं है।
curl --request GET "https://api.temp-number.com/v1/numbers/1482/private-email/inbox/77/attachments/0" \
--header "Authorization: Bearer $TEMP_NUMBER_API_KEY" \
--output receipt.pdf
import { writeFile } from "node:fs/promises";
const response = await fetch("https://api.temp-number.com/v1/numbers/1482/private-email/inbox/77/attachments/0", {
headers: {
Authorization: `Bearer ${process.env.TEMP_NUMBER_API_KEY}`,
},
});
await writeFile("receipt.pdf", Buffer.from(await response.arrayBuffer()));
import os
import requests
response = requests.get(
"https://api.temp-number.com/v1/numbers/1482/private-email/inbox/77/attachments/0",
headers={
"Authorization": f"Bearer {os.environ['TEMP_NUMBER_API_KEY']}",
},
timeout=30,
)
with open("receipt.pdf", "wb") as file:
file.write(response.content)
use Illuminate\Support\Facades\Http;
// config/services.php: 'temp_number' => ['key' => env('TEMP_NUMBER_API_KEY')]
$response = Http::withToken(config('services.temp_number.key'))
->sink(storage_path('receipt.pdf'))
->get('https://api.temp-number.com/v1/numbers/1482/private-email/inbox/77/attachments/0');
HTTP/1.1 200 OK
Content-Type: application/pdf
Content-Disposition: attachment; filename=receipt.pdf
<binary file>
/v1/numbers/{id}/private-email/inbox/{messageId}
ईमेल हटाएँ
ईमेल और उसके अटैचमेंट हटा देता है।
पैरामीटर-
idinteger path ज़रूरीGET /numbers से नंबर id।
-
messageIdinteger path ज़रूरीइनबॉक्स सूची से ईमेल id।
- 404यह आपका नंबर नहीं है, या अभी इसका कोई पता नहीं है।
- 404
private_email_closedनंबर रद्द या रिफ़ंड कर दिया गया था।
curl --request DELETE "https://api.temp-number.com/v1/numbers/1482/private-email/inbox/77" \
--header "Authorization: Bearer $TEMP_NUMBER_API_KEY" \
--header "Accept: application/json"
const response = await fetch("https://api.temp-number.com/v1/numbers/1482/private-email/inbox/77", {
method: "DELETE",
headers: {
Authorization: `Bearer ${process.env.TEMP_NUMBER_API_KEY}`,
Accept: "application/json",
},
});
const result = await response.json();
console.log(response.status, result);
import os
import requests
response = requests.delete(
"https://api.temp-number.com/v1/numbers/1482/private-email/inbox/77",
headers={
"Authorization": f"Bearer {os.environ['TEMP_NUMBER_API_KEY']}",
"Accept": "application/json",
},
timeout=30,
)
print(response.status_code, response.json())
use Illuminate\Support\Facades\Http;
// config/services.php: 'temp_number' => ['key' => env('TEMP_NUMBER_API_KEY')]
$response = Http::withToken(config('services.temp_number.key'))
->acceptJson()
->delete('https://api.temp-number.com/v1/numbers/1482/private-email/inbox/77');
$result = $response->json();
{
"success": true,
"data": null
}
AI और MCP
किसी AI असिस्टेंट को सीधे आपका खाता इस्तेमाल करने दें, या कोडिंग एजेंट को API पर बनाने के लिए ज़रूरी सब कुछ दें।
MCP सर्वर
REST API के साथ-साथ हम एक Model Context Protocol सर्वर भी चलाते हैं। इसे Claude, ChatGPT या अपने एडिटर से जोड़ें और असिस्टेंट नेटिव टूल्स के रूप में कीमतें और स्टॉक देख सकता है, नंबर खरीद सकता है और उसके SMS पढ़ सकता है - आपकी तरफ़ से कोई कोड नहीं। MCP में नए हैं? MCP सर्वर का परिचय से शुरू करें।
एंडपॉइंटhttps://mcp.temp-number.com/mcp
साइन-इन कैसे काम करता है
- URL को अपने AI ऐप में जोड़ें। यह आपको Temp Number पर अपने खाते से साइन इन करने (PKCE के साथ OAuth 2.1) के लिए भेजता है - कोई key कॉपी करने की ज़रूरत नहीं।
- सहमति स्क्रीन पर आप चुनते हैं कि असिस्टेंट क्या कर सकता है। बैलेंस, कीमतें, आपके नंबर और उनके SMS पढ़ना हमेशा शामिल रहता है। Allow purchases - आपके वॉलेट से खरीदना, रिन्यू करना और रद्द करना - तब तक बंद रहता है जब तक आप इसे टिक न करें।
- हर कनेक्शन Dashboard → MCP Server → Connected apps में दिखता है, जहाँ आप इसे कभी भी डिस्कनेक्ट कर सकते हैं।
- key पसंद है (CI, स्क्रिप्ट, headless एजेंट)? उसी पेज पर एक MCP key बनाएँ और उसे
Authorization: Bearer <key>के रूप में भेजें। MCP keys और REST API keys एक-दूसरे की जगह इस्तेमाल नहीं हो सकतीं।
टूल्स
| टूल | यह क्या करता है | "Allow purchases" ज़रूरी है |
|---|---|---|
get-balance | प्रमाणित अकाउंट का वॉलेट बैलेंस और बिलिंग करेंसी प्राप्त करें। | नहीं |
get-pricing | सभी देशों या किसी एक ISO देश कोड के लिए सक्रिय प्राइसिंग कैटलॉग लौटाएँ। | नहीं |
get-inventory | किसी देश, अवधि और वैकल्पिक नंबर प्रकार के लिए लाइव इन्वेंटरी की उपलब्धता देखें। | नहीं |
purchase-number | वॉलेट फ़ंड से प्रमाणित अकाउंट के लिए एक प्राइवेट नंबर खरीदें। | हाँ |
list-active-numbers | प्रमाणित अकाउंट के स्वामित्व वाले नंबर लौटाएँ, वैकल्पिक रूप से स्टेटस के अनुसार फ़िल्टर करके। | नहीं |
check-sms | प्रमाणित अकाउंट के स्वामित्व वाले खरीदे गए नंबर ID के SMS मैसेज प्राप्त करें। | नहीं |
renew-number | वैकल्पिक अवधि पैकेज का इस्तेमाल करके ID से खरीदा गया नंबर रिन्यू करें। | हाँ |
cancel-number | ID से खरीदा गया नंबर कैंसिल करें और लागू होने वाला वॉलेट रिफ़ंड लौटाएँ। | हाँ |
अपना AI टूल कनेक्ट करें
अपना ऐप चुनें। ज़्यादातर एक क्लिक में कनेक्ट हो जाते हैं: आप Temp Number में साइन इन करते हैं, टिक करते हैं कि असिस्टेंट क्या कर सकता है, और Allow पर क्लिक करते हैं।
Claude - claude.ai, डेस्कटॉप और मोबाइल
कुछ भी इंस्टॉल नहीं करना। ब्राउज़र, डेस्कटॉप ऐप और मोबाइल पर काम करता है।
- Add to Claude पर क्लिक करें। Claude खुलेगा जिसमें Temp Number और उसका URL पहले से भरे होंगे। Add पर क्लिक करें।
- Connect पर क्लिक करें, Temp Number में साइन इन करें, चुनें कि Claude खरीदारी कर सकता है या नहीं, और Allow पर क्लिक करें।
- किसी भी चैट में + मेनू → Connectors खोलें और Temp Number चालू करें। आज़माएँ: "एक महीने के लिए US नंबर की कीमत क्या है?"
बटन नहीं दिख रहा? Claude में Customize → Connectors → Add custom connector पर जाएँ और MCP endpoint पेस्ट करें। जिन संगठनों के पास Claude का request-header विकल्प है, वे साइन इन करने के बजाय MCP key को Authorization: Bearer <key> के रूप में भेज सकते हैं।
ChatGPT
वेब पर ChatGPT Business, Enterprise या Edu ज़रूरी है। Business में इसे कोई admin या owner जोड़ता है।
- नीचे दिया गया सर्वर URL कॉपी करें, फिर उसके Plugins पेज पर जाने के लिए Open ChatGPT पर क्लिक करें। ChatGPT में ऐसा कोई लिंक नहीं है जो इसे आपके लिए भर दे।
- + → Add custom MCP server पर क्लिक करें। इसका नाम Temp Number रखें और Connection के नीचे URL पेस्ट करें।
- authentication को OAuth पर सेट करें, जोखिम चेतावनी स्वीकार करें और Create as a plugin पर क्लिक करें।
- जब ChatGPT पूछे, Temp Number में साइन इन करें, चुनें कि ChatGPT खरीदारी कर सकता है या नहीं, और Allow पर क्लिक करें।
- नई चैट में @ टाइप करें और Temp Number चुनें। आज़माएँ: "एक महीने के लिए US नंबर की कीमत क्या है?"
https://mcp.temp-number.com/mcp
Claude Code
सर्वर एक बार जोड़ें, फिर Claude Code के अंदर से साइन इन करें।
claude mcp add --transport http temp-number https://mcp.temp-number.com/mcp
- Claude Code शुरू करें और
/mcpटाइप करें। - temp-number → Authenticate चुनें। आपका ब्राउज़र खुलेगा: साइन इन करें और Allow पर क्लिक करें।
इसके बजाय MCP key का उपयोग (CI / headless)
export TEMPNUMBER_MCP_KEY=your-mcp-key
claude mcp add --transport http temp-number \
https://mcp.temp-number.com/mcp \
--header "Authorization: Bearer $TEMPNUMBER_MCP_KEY"
Codex CLI
सर्वर जोड़ें, फिर साइन इन करें। Codex आपके लिए सेशन सहेज लेता है।
codex mcp add temp-number --url https://mcp.temp-number.com/mcp
codex mcp login temp-number
इसके बजाय MCP key का उपयोग (CI / headless)
~/.codex/config.toml में। key environment से पढ़ी जाती है, इसलिए फ़ाइल शेयर करना सुरक्षित है।
[mcp_servers.temp-number]
url = "https://mcp.temp-number.com/mcp"
bearer_token_env_var = "TEMPNUMBER_MCP_KEY"
Cursor
एक क्लिक, फिर Cursor के पूछने पर साइन इन करें।
या इसे .cursor/mcp.json (या ~/.cursor/mcp.json) में जोड़ें। फिर Cursor सर्वर के पास Needs login दिखाता है: उस पर क्लिक करें, साइन इन करें और Allow पर क्लिक करें।
{
"mcpServers": {
"temp-number": {
"url": "https://mcp.temp-number.com/mcp"
}
}
}
इसके बजाय MCP key का उपयोग
{
"mcpServers": {
"temp-number": {
"url": "https://mcp.temp-number.com/mcp",
"headers": {
"Authorization": "Bearer ${env:TEMPNUMBER_MCP_KEY}"
}
}
}
}
VS Code (GitHub Copilot)
एक क्लिक, फिर पहली बार टूल चलने पर साइन इन करें।
या इसे .vscode/mcp.json में जोड़ें - ध्यान दें कि key servers है, mcpServers नहीं।
{
"servers": {
"temp-number": {
"type": "http",
"url": "https://mcp.temp-number.com/mcp"
}
}
}
इसके बजाय MCP key का उपयोग
VS Code एक बार key माँगता है और उसे अपने secret storage में रखता है।
{
"servers": {
"temp-number": {
"type": "http",
"url": "https://mcp.temp-number.com/mcp",
"headers": {
"Authorization": "Bearer ${input:tempnumber-mcp-key}"
}
}
},
"inputs": [
{
"type": "promptString",
"id": "tempnumber-mcp-key",
"description": "Temp Number MCP key",
"password": true
}
]
}
कोई भी अन्य MCP ऐप
Windsurf, Zed, LibreChat, आपका अपना एजेंट…
- MCP endpoint को remote (streamable HTTP) सर्वर के रूप में जोड़ें। साइन-इन सपोर्ट करने वाले ऐप इसे
https://mcp.temp-number.com/.well-known/oauth-protected-resourceपर खुद ढूँढ लेते हैं और Temp Number की सहमति स्क्रीन खोलते हैं। - जिन ऐप्स में साइन-इन सपोर्ट नहीं है, वे MCP key को
Authorization: Bearer <key>के रूप में भेज सकते हैं।
https://mcp.temp-number.com/mcp
llms.txt और एजेंट प्रॉम्प्ट
AI कोडिंग असिस्टेंट के साथ बना रहे हैं? उसे नीचे दिया गया संदर्भ दें और वह API को एक ही बार में सही तरीके से इंटीग्रेट कर सकता है - auth, idempotency और rate limits समेत।
You are integrating the Temp Number REST API. Read the full, machine-readable reference before writing any code:
- API reference (llms.txt): https://temp-number.com/developers/llms.txt
- OpenAPI spec: https://api.temp-number.com/api.json
- Base URL: https://api.temp-number.com/v1
- MCP server (for AI agents that call tools directly): https://mcp.temp-number.com/mcp - sign in with OAuth, or send an MCP key as a Bearer token.
Rules: authenticate every request with `Authorization: Bearer <YOUR_API_KEY>` (created in the dashboard → API Access) and keep the key in an environment variable, never in code; send and accept JSON over HTTPS; send a unique `Idempotency-Key` (UUID) header on every POST that buys, renews or cancels - it is required, and retries must reuse the same key; branch on the `code` field of error responses, not on the message text; on HTTP 429 or 503, wait for the `Retry-After` header. All prices are final USD.
Task: <describe what you want to build - e.g. "buy a US number, wait for the verification SMS, then cancel it if it never arrives">.
https://temp-number.com/developers/llms.txt हर endpoint का हमेशा अप-टू-डेट, सादा-टेक्स्ट सारांश है; OpenAPI spec टाइप्ड अनुबंध है। दोनों API के साथ अपडेट होते हैं।संसाधन
क्या बदला है, और मदद कहाँ मिलेगी।
चेंजलॉग
केवल जोड़ने वाले बदलाव - /v1 से कुछ भी हटाया नहीं गया है।
-
NewMCP: अपने Temp Number अकाउंट से साइन इन करें
एक क्लिक में "Add to Claude", साथ ही ChatGPT, Claude Code, Codex, Cursor और VS Code, बिना कोई कुंजी कॉपी किए। सहमति स्क्रीन पर आप तय करते हैं कि AI खर्च कर सकता है या नहीं।
-
Docsडॉक्स का नया ठिकाना
क्विकस्टार्ट, खोज, और हर उदाहरण cURL, Node.js, Python और PHP में। त्रुटियाँ, रेट लिमिट और रिफ़ंड अब लाइव API से बिल्कुल मेल खाते हैं।
-
Newपूरी साइट के लिए llms.txt
AI असिस्टेंट के लिए सेवा का सादा-टेक्स्ट नक्शा, जो एजेंट-के-लिए-तैयार API संदर्भ से लिंक करता है।
-
Newअपना AI टूल कनेक्ट करें
Claude Code, Codex, Cursor और VS Code के लिए सेटअप, Cursor और VS Code के लिए एक-क्लिक इंस्टॉल लिंक के साथ।
-
NewOpenAPI spec
मशीन-पठनीय विवरण https://api.temp-number.com/api.json पर उपलब्ध है।
-
Improvedऑब्जेक्ट संदर्भ से मेल खाते हैं
नंबर और SMS में ISO 8601 तारीखें और from/body इस्तेमाल होते हैं। त्रुटियों में मशीन-पठनीय कोड होता है (out_of_stock, insufficient_funds, invalid_duration)। number_type छोड़ने पर /inventory हर नंबर प्रकार की जानकारी देता है। पुराने फ़ील्ड नाम अप्रचलित उपनामों के रूप में अब भी काम करते हैं।
-
Newप्राइवेट ईमेल एंडपॉइंट
किसी नंबर के लिए मुफ़्त [email protected] इनबॉक्स लें, API से मेल पढ़ें और अटैचमेंट डाउनलोड करें।
-
NewMCP सर्वर
AI एजेंट MCP कुंजी का उपयोग करके टूल के रूप में कीमतें देख सकते हैं, नंबर खरीद सकते हैं और SMS पढ़ सकते हैं।
-
Launchसार्वजनिक REST API v1
अकाउंट, कीमतें, इन्वेंटरी, नंबर का पूरा जीवनचक्र और SMS, Bearer-टोकन ऑथेंटिकेशन के साथ।
सपोर्ट
अटक गए, या इन दस्तावेज़ों में कुछ ऐसा मिला जो API के असली व्यवहार से मेल नहीं खाता? हमसे संपर्क करें - एंडपॉइंट, अनुरोध का समय और जवाब की बॉडी शामिल करें (अपनी API कुंजी कभी नहीं)।
बनाना शुरू करने के लिए तैयार हैं?
एक कुंजी बनाएँ और एक मिनट से कम समय में अपनी पहली कॉल करें।