Zyla API Hub पर वर्चुअल फोन नंबर जनरेटर API: curl और JSON के साथ पहला अनुरोध

आपको साइन-अप प्रवाह, QA, या ऑनबोर्डिंग परीक्षणों के लिए एक बार के SMS प्राप्त करने के लिए डिस्पोजेबल वर्चुअल नंबरों की आवश्यकता है, और आपको यह इस सप्ताह काम करने की आवश्यकता है। इस गाइड के अंत तक, आप समर्थित देशों की सूची बनाएंगे, एक देश के लिए उपलब्ध नंबरों को प्राप्त करेंगे, और एक विशिष्ट नंबर के लिए SMS इतिहास पढ़ेंगे—पहले curl का उपयोग करके, फिर एक संक्षिप्त Node.js स्क्रिप्ट जिसका आप अपनी सेवा में उपयोग कर सकते हैं।

वर्चुअल फोन नंबर जनरेटर API क्या करता है

वर्चुअल फोन नंबर जनरेटर API प्रदान करता है:

Illustration: Virtual Phone Number Generator API on Zyla API Hub: First Request with curl and JSON

वर्तमान में उपलब्ध देशों की एक सूची जिनसे आप वर्चुअल नंबर प्राप्त कर सकते हैं।
चुने गए देश कोड के लिए उपलब्ध फोन नंबर।
एक दिए गए फोन नंबर और देश कोड के लिए SMS इतिहास (ताकि आप प्राप्त किए गए सत्यापन कोड पढ़ सकें)।

आम उपयोगों में स्वचालित खाता परीक्षण, बहु-क्षेत्रीय ऑनबोर्डिंग प्रवाह, या प्रोग्रामेटिक रूप से एक नंबर चुनने और इनबाउंड SMS पढ़ने के लिए आंतरिक उपकरण बनाना शामिल है। आप इसे एकल Zyla API Hub कुंजी के साथ एक्सेस कर सकते हैं जिसका आप मार्केटप्लेस में उपयोग करते हैं।

Zyla API Hub एक खाते, एक API कुंजी, और एक सब्सक्रिप्शन मॉडल के पीछे 10,000 से अधिक सार्वजनिक APIs को एकत्र करता है। zylalabs.com पर मार्केटप्लेस का अन्वेषण करें।

Zyla API Hub पर शुरू करना

वर्चुअल फोन नंबर जनरेटर API पृष्ठ को Zyla API Hub पर खोलें और सब्सक्राइब पर क्लिक करें। Zyla एक सब्सक्रिप्शन + कोटा मॉडल का उपयोग करता है (पे-पर-कॉल नहीं)। इस API के लिए, पहला सब्सक्रिप्शन 7 दिन का परीक्षण या 50 अनुरोध प्रदान करता है। कोई मुफ्त योजना नहीं है। वर्तमान एक्सेस विकल्पों और मूल्य निर्धारण के लिए API पृष्ठ की जांच करें।

सब्सक्राइब करने के बाद, आपको एक API कुंजी मिलेगी। सभी अनुरोधों में Authorization हेडर का उपयोग करें: Authorization: Bearer YOUR_API_KEY

यदि आपके पास अभी तक एक खाता नहीं है, तो आप यहां एक बना सकते हैं: रजिस्टर करें.

आप जिन एंडपॉइंट्स का उपयोग करेंगे

सभी अनुरोध Zyla के हब URLs पर जाते हैं। मूल विक्रेता डोमेन को कॉल न करें। अपने कुंजी को Authorization हेडर में पास करें।

1) देशों को प्राप्त करें

वर्तमान में उपलब्ध देशों की सूची लौटाता है।

विधि: GET
URL: https://zylalabs.com/api/1813/virtual-phone-number-generator-api/1466/get-countries
पैरामीटर्स: कोई प्रलेखित नहीं

curl:

curl -s -X GET "https://zylalabs.com/api/1813/virtual-phone-number-generator-api/1466/get-countries" \
-H "Authorization: Bearer YOUR_API_KEY"

आधिकारिक नमूना प्रतिक्रिया:

{
"status": 200,
"success": true,
"message": "",
"data": [
{
"countryCode": "1",
"countryName": "संयुक्त राज्य अमेरिका
"
},
{
"countryCode": "1",
"countryName": "कनाडा
"
},
{
"countryCode": "44",
"countryName": "यूनाइटेड किंगडम
"
},
{
"countryCode": "34",
"countryName": "स्पेन
"
},
{
"countryCode": "972",
"countryName": "इज़राइल
"
},
{
"countryCode": "230",
"countryName": "मॉरिशस
"
},
{
"countryCode": "91",
"countryName": "भारत
"
},
{
"countryCode": "385",
"countryName": "क्रोएशिया
"
},
{
"countryCode": "351",
"countryName": "पुर्तगाल
"
},
{
"countryCode": "381",
"countryName": "सर्बिया
"
},
{
"countryCode": "52",
"countryName": "मैक्सिको
"
},
{
"countryCode": "55",
"countryName": "ब्राज़ील
"
},
{
"countryCode": "234",
"countryName": "नाइजीरिया
"
}
]
}

क्या पढ़ें:

status और success: बुनियादी अनुरोध स्थिति।
data: देशों का एक एरे। प्रत्येक आइटम में शामिल हैं:
- countryCode: स्ट्रिंग अंतरराष्ट्रीय डायलिंग प्रीफिक्स (उदाहरण के लिए, "44").
- countryName: स्ट्रिंग देश का नाम; ध्यान दें कि इसमें ट्रेलिंग व्हाइटस्पेस/न्यूलाइन शामिल हैं—अपने कोड में इसे ट्रिम करें।

2) देश आईडी द्वारा नंबर प्राप्त करें

एक दिए गए देश कोड के लिए वर्तमान में उपलब्ध नंबर लौटाता है। इस एंडपॉइंट से नंबरों का उपयोग Check SMS history एंडपॉइंट के साथ किया जा सकता है।

विधि: GET
URL: https://zylalabs.com/api/1813/virtual-phone-number-generator-api/1467/get-number-by-country-id
आवश्यक क्वेरी पैरामीटर:
- countryCode (स्ट्रिंग): उदाहरण के लिए, 44

curl:

उदाहरण प्रतिक्रिया:

क्या पढ़ें:

data: फोन नंबरों का एक एरे स्ट्रिंग के रूप में। Check SMS history के लिए, आपको नंबर भेजने से पहले देश कोड प्रीफिक्स को हटाने की आवश्यकता हो सकती है (SMS history एंडपॉइंट के तहत नोट देखें)।

3) SMS इतिहास की जांच करें

निर्दिष्ट फोन नंबर और देश कोड द्वारा प्राप्त SMS संदेश लौटाता है।

विधि: GET
URL: https://zylalabs.com/api/1813/virtual-phone-number-generator-api/1469/check-sms-history
आवश्यक क्वेरी पैरामीटर्स:
- countryCode (स्ट्रिंग): उदाहरण के लिए, 1
- phoneNumber (स्ट्रिंग): उदाहरण के लिए, 8578329806

API से महत्वपूर्ण नोट: यदि आप देश आईडी द्वारा प्राप्त नंबर का उपयोग करते हैं, तो इसे यहां पास करने से पहले देश कोड हटा दें। अधिकांश देशों के लिए, इसका अर्थ है पूर्ण नंबर से पहले के 2 अंकों को हटाना। हमेशा सुनिश्चित करें कि आप सही countryCode के साथ केवल स्थानीय नंबर भाग पास करें।

curl:

एंडपॉइंट उस नंबर के लिए SMS इतिहास लौटाता है। यहाँ सटीक प्रतिक्रिया फ़ील्ड प्रलेखित नहीं हैं; अपने कार्यप्रवाह के लिए आवश्यकतानुसार कच्चे JSON को लॉग करें और संदेश सामग्री और टाइमस्टैम्प को पार्स करें।

Node.js त्वरित प्रारंभ (फेच + न्यूनतम पार्सिंग)

निम्नलिखित Node.js उदाहरण सामान्य प्रवाह के माध्यम से चलता है: देशों की सूची बनाना, एक देश कोड चुनना, उपलब्ध नंबर प्राप्त करना, SMS इतिहास के लिए नंबर को सामान्य बनाना, फिर इनबॉक्स प्राप्त करना। यह ऊपर वर्णित सटीक एंडपॉइंट्स और हेडर्स का उपयोग करता है।

/**
* Node.js 18+ (global fetch). Set YOUR_API_KEY via env or replace inline.
* This script:
* 1) Lists countries
* 2) Fetches numbers for a selected country code
* 3) Normalizes the number for SMS history
* 4) Fetches SMS history JSON and prints it
*/
const API_KEY = process.env.ZYLA_API_KEY || 'YOUR_API_KEY';
const BASE = 'https://zylalabs.com/api/1813/virtual-phone-number-generator-api';

async function getCountries() {
const res = await fetch(`${BASE}/1466/get-countries`, {
headers: { Authorization: `Bearer ${API_KEY}` }
});
if (!res.ok) throw new Error(`get-countries failed: ${res.status}`);
const json = await res.json();
return json;
}

async function getNumbersByCountryCode(countryCode) {
const url = `${BASE}/1467/get-number-by-country-id?countryCode=${encodeURIComponent(countryCode)}`;
const res = await fetch(url, { headers: { Authorization: `Bearer ${API_KEY}` } });
if (!res.ok) throw new Error(`get-number-by-country-id failed: ${res.status}`);
const json = await res.json();
return json;
}

async function checkSmsHistory(countryCode, phoneNumber) {
const url = `${BASE}/1469/check-sms-history?countryCode=${encodeURIComponent(countryCode)}&phoneNumber=${encodeURIComponent(phoneNumber)}`;
const res = await fetch(url, { headers: { Authorization: `Bearer ${API_KEY}` } });
if (!res.ok) throw new Error(`check-sms-history failed: ${res.status}`);
const json = await res.json();
return json;
}

// Remove country code prefix from a full E.164-like string when required.
// The API notes: For most countries, remove the first 2 digits.
// Behavior can vary; double-check your target country.
function stripCountryCode(fullNumber, countryCode) {
const cc = String(countryCode);
return fullNumber.startsWith(cc) ? fullNumber.slice(cc.length) : fullNumber;
}

function trimCountryName(name) {
return String(name).trim();
}

(async () => {
// 1) Countries
const countries = await getCountries();
console.log('Countries raw:', countries);

// Choose a country code (example: use United Kingdom "44" if available)
const uk = (countries.data || []).find(c => trimCountryName(c.countryName) === 'United Kingdom');
const countryCode = uk ? uk.countryCode : '44';
console.log('Using countryCode:', countryCode);

// 2) Numbers for that country
const numbers = await getNumbersByCountryCode(countryCode);
console.log('Numbers raw:', numbers);

if (!numbers.data || numbers.data.length === 0) {
console.log('No numbers available for countryCode', countryCode);
return;
}

const fullNumber = numbers.data[0];
// 3) Normalize for SMS history as per API guidance
const localNumber = stripCountryCode(fullNumber, countryCode);
console.log('Full number:', fullNumber, 'Local for history:', localNumber);

// 4) SMS history
const inbox = await checkSmsHistory(countryCode, localNumber);
console.log('SMS history raw:', inbox);

// Because the response shape is not documented here,
// process the payload based on your observed structure.
})();

curl के साथ पहले कॉल

डेवलपर्स अक्सर प्रमाणीकरण और प्रतिक्रिया आकार को मान्य करने के लिए curl के साथ शुरू करते हैं। ये तीन आदेश सामान्य पथ को कवर करते हैं।

देशों की सूची:
यूके नंबर प्राप्त करें (countryCode=44): अपेक्षित आकार:
SMS इतिहास की जांच करें (यूएस कोड 1 और स्थानीय नंबर 8578329806 के साथ उदाहरण):

व्यावहारिक एकीकरण नोट्स

Auth हेडर: हमेशा Authorization: Bearer YOUR_API_KEY भेजें। क्वेरी पैरामीटर के रूप में कुंजी न भेजें।
देश के नाम: countryName मानों में ट्रेलिंग व्हाइटस्पेस या न्यूलाइन वर्ण शामिल हो सकते हैं। तुलना या प्रदर्शित करने से पहले ट्रिम करें।
नंबर सामान्यीकरण: जब आप देश आईडी द्वारा नंबर प्राप्त करते हैं, तो Check SMS history को कॉल करने से पहले देश कोड को हटा दें। अधिकांश देशों के लिए, पहले 2 अंकों को हटा दें। अपने लक्षित क्षेत्र के लिए परीक्षण अनुरोधों के साथ मान्य करें।
कैशिंग: देशों की सूची आमतौर पर इनबॉक्स डेटा की तुलना में कम बार बदलती है। अपने उपयोग के मामले और कोटा रणनीति के आधार पर मिनटों से घंटों के लिए Get Countries को कैश करें।
कोटा: Zyla APIs एक सब्सक्रिप्शन + कोटा मॉडल पर चलते हैं। इस API के लिए, पहला सब्सक्रिप्शन 7 दिन का परीक्षण या 50 अनुरोध शामिल करता है। अपने Zyla डैशबोर्ड में उपयोग की निगरानी करें।
त्रुटि हैंडलिंग: HTTP स्थिति कोड और JSON स्थिति/सफलता फ़ील्ड की जांच करें। विकास के दौरान कच्ची प्रतिक्रियाओं को लॉग करें ताकि किसी भी मान्यता त्रुटियों को समझा जा सके।
पर्यावरण: कोटा और लॉग को अलग करने के लिए विकास और उत्पादन परियोजनाओं के लिए अलग कुंजी का उपयोग करें।

सामान्य कार्यप्रवाह

स्वचालित परीक्षण खाता निर्माण

Get Countries को कॉल करें और उस देश का चयन करें जहां आपके उत्पाद का ऑनबोर्डिंग परीक्षण किया जाना चाहिए।
Get Number by Country Id के साथ एक नंबर प्राप्त करें।
अपने लक्षित ऐप को उस नंबर पर SMS भेजने के लिए ट्रिगर करें।
सत्यापन कोड पढ़ने के लिए countryCode + स्थानीय नंबर के साथ Check SMS history को कॉल करें।

बहु-क्षेत्रीय ऑनबोर्डिंग

Get Countries से देश कोड की एक अनुमति सूची प्रीलोड करें।
प्रत्येक क्षेत्र के लिए, Get Number by Country Id से उपलब्ध नंबरों के माध्यम से घुमाएँ।
Cross-border प्रवाह को अनब्लॉक करने के लिए Check SMS history के माध्यम से SMS सामग्री प्राप्त करें और पार्स करें।

आंतरिक उपकरण

अपने टीम के SSO के साथ तीन एंडपॉइंट्स को लपेटने वाला एक छोटा डैशबोर्ड बनाएं।
Get Countries और Get Number by Country Id से प्रति देश उपलब्धता दिखाएं।
Check SMS history का उपयोग करके प्रति नंबर "नवीनतम SMS पढ़ें" बटन प्रदान करें।

MCP के माध्यम से एक AI एजेंट से इस API को कॉल करें

आप इस API को MCP-संगत उपकरणों (Claude Code, Cursor, Windsurf, आदि) से भी एक्सेस कर सकते हैं। अपने एजेंट को MCP गेटवे पर इंगित करें:

एंडपॉइंट: https://mcp.zylalabs.com/mcp?apikey=YOUR_API_KEY

एक बार कॉन्फ़िगर होने के बाद, एजेंट को वही अनुक्रम करने के लिए निर्देशित करें जिसका आपने ऊपर उपयोग किया: देशों की सूची बनाना, एक countryCode चुनना, नंबर प्राप्त करना, चुने गए नंबर से देश कोड को हटाना, फिर स्थानीय नंबर के साथ SMS इतिहास एंडपॉइंट को कॉल करना। MCP एक्सेस के लिए पृष्ठभूमि के लिए, MCP पृष्ठ देखें।

अन्वेषण करने के लिए कहां और अगले कदम

API लिस्टिंग से शुरू करें और हब कंसोल पर curl नमूनों का परीक्षण करें: वर्चुअल फोन नंबर जनरेटर API. zylalabs.com पर अन्य श्रेणियों को ब्राउज़ करें—एक खाते और एक API कुंजी के तहत 10,000 से अधिक सार्वजनिक APIs हैं।

FAQ

मैं अनुरोधों को कैसे प्रमाणित करूं?
हर अनुरोध पर HTTP हेडर भेजें: Authorization: Bearer YOUR_API_KEY Zyla Hub URLs पर।

मुझे Get Number by Country Id को कौन सा देश कोड पास करना चाहिए?
Get Countries द्वारा लौटाए गए countryCode मान का उपयोग करें (उदाहरण के लिए, "44" यूनाइटेड किंगडम के लिए)। यह एक स्ट्रिंग है; इसे अपने क्वेरी पैरामीटर में जैसा है वैसा ही रखें।

क्यों Check SMS history पूर्ण नंबर के साथ काम नहीं करता है जो Get Number by Country Id से प्राप्त होता है?
API नोट के अनुसार, Check SMS history को phoneNumber पास करते समय देश कोड हटा दें। अधिकांश देशों के लिए, इसका अर्थ है पहले दो अंकों को गिराना। countryCode को अलग क्वेरी पैरामीटर के रूप में रखें।

क्या कोई मुफ्त योजना है?
कोई मुफ्त योजना नहीं है। पहला सब्सक्रिप्शन 7 दिन का परीक्षण या 50 अनुरोध प्रदान करता है। वर्तमान एक्सेस विकल्पों और मूल्य निर्धारण के लिए API पृष्ठ की जांच करें।

क्या मैं इन APIs को AI कोडिंग सहायक से कॉल कर सकता हूं?
हाँ। MCP-संगत क्लाइंट में https://mcp.zylalabs.com/mcp?apikey=YOUR_API_KEY पर MCP एंडपॉइंट का उपयोग करें और एजेंट के माध्यम से वही एंडपॉइंट कॉल जारी करें।

क्या आप अपने एकीकरण को शिप करने के लिए तैयार हैं? अपना खाता बनाएं, सब्सक्राइब करें, और अभी अपनी कुंजी प्राप्त करें: रजिस्टर करें. फिर अपना पहला अनुरोध करने के लिए वर्चुअल फोन नंबर जनरेटर API खोलें।