आपको OTP, SMS सूचनाएँ भेजने या उपयोगकर्ता साइन-अप सक्षम करने से पहले फोन नंबरों की पुष्टि करनी होगी। इस वॉकथ्रू के अंत तक, आप एक फोन नंबर को मान्य करेंगे, कैरियर/देश/फॉर्मेट मेटाडेटा का निरीक्षण करेंगे, और Zyla API Hub पर फोन वेलिडेटर API का उपयोग करके Postman में सब कुछ परीक्षण करेंगे।
फोन वेलिडेटर API क्या करता है
फोन वेलिडेटर API यह सत्यापित करता है कि क्या एक फोन नंबर मान्य है और समृद्ध मेटाडेटा लौटाता है जिसका आप संदेशों को रूट, फॉर्मेट या ब्लॉक करने के लिए उपयोग कर सकते हैं। प्रतिक्रिया में वैधता ध्वज, कैरियर/प्रदाता, देश और ISO कोड, राष्ट्रीय/अंतर्राष्ट्रीय फॉर्मेट, समय क्षेत्र, लाइन प्रकार (जैसे, मोबाइल) और अधिक शामिल हैं।
विशिष्ट उपयोग के मामले:
- खाते बनाने से पहले अमान्य या डिस्पोजेबल नंबरों को ब्लॉक करें।
- संगत डाउनस्ट्रीम प्रोसेसिंग के लिए E.164 या अंतर्राष्ट्रीय शैली में नंबरों को फॉर्मेट करें।
- लाइन प्रकार के आधार पर SMS बनाम वॉयस भेजने का निर्णय लें।
- प्रशासन उपकरण में भू-जानकारी से अवगत जानकारी (देश, समय क्षेत्र) प्रदर्शित करें।
जैसे कि Zyla API Hub पर सभी सेवाओं के साथ, आप मार्केटप्लेस में एक खाते और एक API कुंजी का उपयोग करते हैं, जिसमें एक सब्सक्रिप्शन-और-कोटा मॉडल है (पे-पर-कॉल नहीं)। इस API के लिए, पहला योजना 7-दिन का परीक्षण या 50 अनुरोध प्रदान करती है, और कोई मुफ्त योजना नहीं है। वर्तमान पहुंच विकल्पों और मूल्य निर्धारण के लिए API पृष्ठ की जांच करें।
Zyla API Hub पर शुरू करना
फोन वेलिडेटर API को मिनटों में आजमाने के लिए:
- API पृष्ठ खोलें: फोन वेलिडेटर API.
- सब्सक्राइब पर क्लिक करें (या उपलब्ध होने पर मुफ्त परीक्षण शुरू करें)। पहला योजना 7-दिन का परीक्षण या 50 अनुरोध प्रदान करता है; कोई मुफ्त योजना नहीं है।
- अपने डैशबोर्ड से अपनी API कुंजी कॉपी करें। सभी कॉल्स हेडर Authorization: Bearer YOUR_API_KEY का उपयोग करती हैं।
यदि आपके पास अभी तक खाता नहीं है, तो आप रजिस्टर करके एक बना सकते हैं और एक API कुंजी प्राप्त कर सकते हैं।
आप जो एंडपॉइंट उपयोग करेंगे
फोन वेलिडेटर API Zyla API Hub पर यह एंडपॉइंट उजागर करता है:
-
फोन वैलिडेशन
विधि: GET
URL: https://zylalabs.com/api/10138/phone-validator-api/26579/phone-validation
आवश्यक क्वेरी पैरामीटर:phone(string): मान्य करने के लिए फोन नंबर, जैसे,+41799530236
Postman के साथ परीक्षण करें
1) एक अनुरोध बनाएं
Postman में निम्नलिखित के साथ एक नया GET अनुरोध सेट करें:
- विधि: GET
- URL:
https://zylalabs.com/api/10138/phone-validator-api/26579/phone-validation?phone=%2B41799530236
2) प्राधिकरण जोड़ें
हेडर्स के तहत, जोड़ें:
Authorization:Bearer YOUR_API_KEY
3) भेजें और प्रतिक्रिया का निरीक्षण करें
भेजें पर क्लिक करें। आपको नंबर के लिए वैधता और मेटाडेटा के साथ एक JSON प्रतिक्रिया प्राप्त करनी चाहिए।
आधिकारिक cURL जिसे आप कॉपी कर सकते हैं
curl -s -X GET "https://zylalabs.com/api/10138/phone-validator-api/26579/phone-validation?phone=%2B41799530236"
-H "Authorization: Bearer YOUR_API_KEY"आधिकारिक उदाहरण प्रतिक्रिया
{
"is_valid": true,
"is_disposable": false,
"provider": "Swisscom",
"location": "Switzerland",
"country": "Switzerland",
"country_iso2": "CH",
"country_iso3": "CHE",
"country_code": 41,
"continent": "Europe",
"time_zones": [
"Europe/Zurich"
],
"format_national": "079 953 02 36",
"format_e164": "+41799530236",
"format_international": "+41 79 953 02 36",
"format_rfc3966": "tel:+41-79-953-02-36",
"line_type": "mobile",
"is_mobile": true,
"is_possible": true,
"national_number": "799530236",
"country_flag": "🇨🇭",
"currency_code": "CHF",
"utc_offset": "+02:00"
}आप जिन फ़ील्ड हाइलाइट्स का उपयोग करेंगे:
is_validऔरis_possible: खाता निर्माण और संदेश भेजने का गेट।line_typeऔरis_mobile: SMS या वैकल्पिक चैनलों के माध्यम से सूचनाएँ रूट करें।format_e164औरformat_international: अपने DB में एक कैनोनिकल फॉर्मेट बनाए रखें और प्रशासन UI में एक उपयोगकर्ता-अनुकूल संस्करण दिखाएँ।providerऔरcountry_iso2: एनालिटिक्स और रूटिंग लॉजिक।time_zonesऔरutc_offset: प्राप्तकर्ता के स्थान में रात में संदेश भेजने से बचें।
JavaScript उदाहरण (Node.js)
यह उदाहरण उसी एंडपॉइंट को कॉल करता है और उन फ़ील्ड का उपयोग करता है जिनकी आपको आमतौर पर SMS के साथ आगे बढ़ने का निर्णय लेने के लिए आवश्यकता होती है:
import fetch from "node-fetch";
async function validatePhone(phone) {
const url = new URL("https://zylalabs.com/api/10138/phone-validator-api/26579/phone-validation");
url.searchParams.set("phone", phone);
const res = await fetch(url.toString(), {
method: "GET",
headers: {
"Authorization": "Bearer YOUR_API_KEY"
}
});
if (!res.ok) {
const text = await res.text();
throw new Error(`HTTP ${res.status}: ${text}`);
}
const data = await res.json();
// न्यूनतम गेटिंग लॉजिक
if (!data.is_valid || !data.is_possible) {
return { ok: false, reason: "Invalid or impossible number", data };
}
if (data.line_type !== "mobile" || !data.is_mobile) {
return { ok: false, reason: "Non-mobile line; SMS may fail", data };
}
// स्टोरेज और डाउनस्ट्रीम सिस्टम के लिए कैनोनिकल E.164 का उपयोग करें
return {
ok: true,
e164: data.format_e164,
provider: data.provider,
country: data.country,
iso2: data.country_iso2,
timeZones: data.time_zones,
rfc3966: data.format_rfc3966,
data
};
}
validatePhone("+41799530236")
.then(result => console.log(JSON.stringify(result, null, 2)))
.catch(err => console.error(err));वर्कफ़्लो पैटर्न जो शिप होते हैं
- साइनअप गेटिंग: उपयोगकर्ता पंजीकरण पर, एंडपॉइंट को कॉल करें। यदि
!is_validया!is_possible, सबमिशन को ब्लॉक करें और सुधार के लिए प्रॉम्प्ट करें। - नंबर सामान्यीकरण:
format_e164को कैनोनिकल मान के रूप में स्टोर करें। ऑपरेटर-फेसिंग दृश्य के लिएformat_internationalका उपयोग करें और स्थानीय प्रदर्शन के लिएformat_nationalका उपयोग करें। - मैसेजिंग गार्डरेल्स: केवल तब SMS को एनक्यू करें जब
is_mobile === trueऔरline_type === "mobile"। वैकल्पिक रूप से, संदेशों को स्थानीयtime_zonesके व्यावसायिक घंटों के भीतर आने तक विलंबित करें। - रूटिंग और लागत-जागरूकता: एनालिटिक्स या प्रति-क्षेत्र भेजने की रणनीतियों के लिए
country_iso2,country_code, औरproviderद्वारा ट्रैफ़िक को विभाजित करें।
समय बचाने वाले कार्यान्वयन नोट्स
- प्राधिकरण: अनुरोधों में हमेशा
Authorization: Bearer YOUR_API_KEYशामिल करें। - Idempotency: वैलिडेशन केवल पढ़ने के लिए है; आप अस्थायी नेटवर्क त्रुटियों पर सुरक्षित रूप से पुनः प्रयास कर सकते हैं।
- कैशिंग: चूंकि नंबर मेटाडेटा अपेक्षाकृत स्थिर है, सकारात्मक वैलिडेशन को
format_e164द्वारा की गई कुंजी के साथ कैश करें ताकि दोहराए गए लुकअप को कम किया जा सके। - अंतर्राष्ट्रीय फॉर्मेटिंग: प्रोग्रामेटिक उपयोग के लिए
format_e164को प्राथमिकता दें। यह स्पेस और हाइफन को हटा देता है और अग्रणी “+” को शामिल करता है। - समय और स्थान:
utc_offsetएक स्ट्रिंग के रूप में लौटाया जाता है (जैसे, +02:00)। सटीक परिवर्तनों के लिएtime_zonesका उपयोग करें। - त्रुटि हैंडलिंग: गैर-2xx HTTP प्रतिक्रियाओं को परिचालन विफलताओं के रूप में मानें; कोटा या प्राधिकरण मुद्दों की पहचान करने में मदद करने के लिए प्रतिक्रिया निकायों को लॉग करें।
- सब्सक्रिप्शन मॉडल: Zyla सब्सक्रिप्शन + कोटा का उपयोग करता है, न कि पे-पर-कॉल। इस API की पहली योजना 7-दिन का परीक्षण या 50 अनुरोध प्रदान करती है; कोई मुफ्त योजना नहीं है। अपने Zyla डैशबोर्ड में अपने उपयोग की निगरानी करें।
समस्या निवारण चेकलिस्ट
- 401/403? सुनिश्चित करें कि प्राधिकरण हेडर मौजूद है और API कुंजी मान्य है।
- 4xx के साथ संदेश सामग्री? जांचें कि
phoneक्वेरी पैरामीटर प्रदान किया गया है और URL-कोडित है। - खाली या अप्रत्याशित फ़ील्ड? किनारे के मामलों को समाप्त करने के लिए एक अलग नंबर के साथ मान्य करें।
format_e164को बनाए रखें और फिर से चलाएँ। - ऐप-विशिष्ट मुद्दे? स्थानीय पार्सिंग कोड के खिलाफ त्वरित डिफ़िंग के लिए कच्ची JSON प्रतिक्रिया को लॉग करें।
AI एजेंटों के माध्यम से MCP से API कॉल करें
Zyla पर हर API को Claude Code, Cursor, और Windsurf जैसे MCP-संगत उपकरणों से कॉल किया जा सकता है। अपने एजेंट या क्लाइंट को MCP एंडपॉइंट पर इंगित करें और क्वेरी स्ट्रिंग में अपनी API कुंजी पास करें:
https://mcp.zylalabs.com/mcp?apikey=YOUR_API_KEY
वहाँ से, आपका एजेंट मार्केटप्लेस रूटिंग का उपयोग करके उसी फोन वैलिडेशन एंडपॉइंट को सक्रिय कर सकता है। एकीकरण विशिष्टताओं और क्लाइंट सेटअप के लिए, MCP दस्तावेज़ देखें। यह तब उपयोगी होता है जब आप चाहते हैं कि एक AI सहायक कोड जनरेशन या परीक्षण रन के दौरान इनलाइन नंबरों को मान्य करे।
आप पुन: उपयोग कर सकने योग्य Postman नुस्खा
अनुरोध सेटअप
- नया अनुरोध → GET
- URL:
https://zylalabs.com/api/10138/phone-validator-api/26579/phone-validation?phone=%2B41799530236 - हेडर्स:
Authorization: Bearer YOUR_API_KEY - भेजें
त्वरित परीक्षण स्क्रिप्ट (वैकल्पिक)
यदि आप Postman परीक्षण का उपयोग करते हैं, तो आप त्वरित सत्यापन जोड़ सकते हैं जैसे:
pm.test("HTTP 200", function () {
pm.response.to.have.status(200);
});
const body = pm.response.json();
pm.test("Valid mobile number", function () {
pm.expect(body.is_valid).to.eql(true);
pm.expect(body.is_mobile).to.eql(true);
});इस एकीकरण के लिए Zyla API Hub का उपयोग क्यों करें
- हब पर 10,000 से अधिक सार्वजनिक APIs में एक खाता, एक API कुंजी, एक सब्सक्रिप्शन मॉडल।
- सब्सक्रिप्शन + कोटा (पे-पर-कॉल नहीं) के साथ केंद्रीकृत बिलिंग, और उपयोग की निगरानी के लिए डैशबोर्ड।
- एंडपॉइंट्स के बीच सुसंगत प्रमाणीकरण: आपकी कुंजी के साथ प्राधिकरण हेडर।
जब आप इस वर्कफ़्लो का विस्तार करने के लिए तैयार हों (जैसे, मैसेजिंग, समृद्धि, या धोखाधड़ी उपकरण) बिना प्रमाणीकरण मॉडल को स्विच किए, तो Zyla API Hub पर अतिरिक्त सेवाओं का अन्वेषण करें।
अक्सर पूछे जाने वाले प्रश्न
मान्यता के लिए सटीक एंडपॉइंट क्या है?
GET https://zylalabs.com/api/10138/phone-validator-api/26579/phone-validation का उपयोग करें जिसमें phone क्वेरी पैरामीटर है।
मैं प्रमाणीकरण कैसे करूँ?
हेडर में अपनी कुंजी पास करें: Authorization: Bearer YOUR_API_KEY.
क्या कोई मुफ्त योजना है?
नहीं। पहला योजना 7-दिन का परीक्षण या 50 अनुरोध प्रदान करता है। वर्तमान पहुंच विकल्पों और मूल्य निर्धारण के लिए API पृष्ठ की जांच करें।
मुझे कौन से फ़ील्ड स्टोर करने चाहिए?format_e164 को कैनोनिकल नंबर के रूप में बनाए रखें। यदि वे आपकी रूटिंग या एनालिटिक्स के लिए प्रासंगिक हैं, तो is_valid, is_possible, line_type, country_iso2, और provider को स्टोर करें।
क्या मैं इसे AI एजेंट से कॉल कर सकता हूँ?
हाँ, MCP एंडपॉइंट के माध्यम से https://mcp.zylalabs.com/mcp?apikey=YOUR_API_KEY पर। क्लाइंट विशिष्टताओं के लिए MCP दस्तावेज़ देखें।
क्या आप अपने स्टैक में फोन वेलिडेटर API का परीक्षण करने के लिए तैयार हैं? फोन वेलिडेटर API पृष्ठ खोलें, सब्सक्राइब करें, और इसे Postman या कोड से कॉल करना शुरू करें। यदि आपको एक खाता चाहिए, तो रजिस्टर करें ताकि आप अपनी API कुंजी प्राप्त कर सकें और इस सप्ताह अपनी एकीकरण को शिप कर सकें।
