फ़ोन नंबर सत्यापन और स्वरूपण API

फ़ोन सत्यापन API 242 देशों में समर्थित है।

फ़ोन नंबर सत्यापन और स्वरूपण API आपको उपयोगकर्ताओं द्वारा दर्ज किए गए फ़ोन नंबरों को विभिन्न स्वरूपों में आसानी से संसाधित करने की सुविधा देता है। चाहे इनपुट 1(212)-867-53-09, +1 212 8675309, 001-212.867.5309 या सिर्फ 2128675309 हो, हमारा API संरचना को समझदारी से पहचानता है और एक मानकीकृत संस्करण प्रदान करता है।

यह टूल दी गई इनपुट को स्वतः E.164 स्वरूप में बदल देता है, जो अंतरराष्ट्रीय फ़ोन नंबरों के लिए वैश्विक रूप से मान्यता प्राप्त प्रारूप है। उदाहरण के लिए, +1 212 867 5309 को +12128675309 के रूप में लौटाया जाता है, जिससे यह अंतरराष्ट्रीय कॉलिंग सिस्टम और एकीकरण के लिए उपयुक्त हो जाता है।

स्वरूपण से परे, यह API विस्तृत फ़ोन नंबर सत्यापन क्षमताएँ प्रदान करता है। यह जांचता है कि नंबर isValid: true है — अर्थात यह राष्ट्रीय नंबरिंग योजनाओं के अनुसार वैध है। यह isPossible: true की भी जांच करता है, जो संकेत देता है कि नंबर संभवतः मौजूद हो सकता है भले ही वह वर्तमान में आवंटित न हो। यह पूर्व-सत्यापन के लिए उपयोगी है।

numberType पैरामीटर यह पहचानने में मदद करता है कि फ़ोन नंबर मोबाइल, लैंडलाइन या VoIP है। यह तब विशेष रूप से उपयोगी होता है जब आप केवल मोबाइल नंबरों को SMS सत्यापन के लिए या ऑफिस संपर्कों के लिए लैंडलाइन की अनुमति देना चाहते हैं।

क्षेत्र कोड पहचान समर्थन के साथ, API नंबर की भौगोलिक उत्पत्ति का भी पता लगा सकता है। उदाहरण के लिए, यदि क्षेत्र कोड 212 से शुरू होता है, तो यह अपने आप न्यूयॉर्क सिटी (मैनहटन) से जोड़ा जाता है। यह सुविधा स्थान-आधारित विभाजन या विश्लेषण की आवश्यकता वाली ऐप्लिकेशन के लिए आदर्श है।

प्रत्येक नंबर के साथ विस्तृत देश-स्तरीय मेटाडेटा भी जुड़ा होता है, जैसे ISO क्षेत्र कोड (जैसे US) और संख्यात्मक देश कोड (जैसे 1) जो आपके ऐप्लिकेशन में क्षेत्र-विशिष्ट लॉजिक और स्वरूपण को सक्षम करता है।

✅ API प्रतिक्रिया

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

{
  "status": true,
  "remaining_credits": 15709,
  "expires": 0,
  "duration": "18ms",
  "regionCode": "US",
  "countryCode": 1,
  "country":"Unites States",
  "national": "(212) 867-5309",
  "international": "+1 212-867-5309",
  "e164": "+12128675309",
  "isValid": true,
  "isPossible": true,
  "numberType": "FIXED_LINE_OR_MOBILE",
  "nationalSignificantNumber": "2128675309",
  "rawInput": "+1 212 867 5309",
  "isGeographical": true,
  "areaCode": "212",
  "location": "New York City (Manhattan)"
}

Phone Validation API को स्वयं आज़माएं

मूल उपयोग

निम्नलिखित एंडपॉइंट पर एक फ़ोन नंबर भेजें:

https://api.genderapi.io/api/phone?key=YOUR_API_KEY&number=12128675309

आप इस लिंक से प्रतिदिन 200 क्रेडिट के साथ एक मुफ्त API कुंजी प्राप्त कर सकते हैं।

पता पैरामीटर

API एक वैकल्पिक address पैरामीटर का भी समर्थन करता है, जो तब बहुत उपयोगी होता है जब फ़ोन नंबर अंतरराष्ट्रीय देश कोड के बिना दिया गया हो। यह फ़ील्ड सिस्टम को इच्छित क्षेत्र का पता लगाने और संख्या को सही ढंग से पार्स करने में मदद करती है। उदाहरण के लिए, यदि इनपुट 2128675309 है और कोई देश कोड निर्दिष्ट नहीं है, तो address=US, address=United States या address=New York सेट करने से API यह निर्धारित कर सकता है कि यह नंबर संयुक्त राज्य अमेरिका से संबंधित है।

address पैरामीटर कई प्रारूपों में इनपुट स्वीकार करता है, जैसे:

• ISO 3166-1 alpha-2 कोड जैसे US, DE, या TR
• देशों के नाम जैसे Germany, Turkey, या America
• शहर या क्षेत्र के नाम जैसे Berlin, Istanbul, या New York

यद्यपि यह वैकल्पिक है, यदि फ़ोन नंबर प्लस चिन्ह और अंतरराष्ट्रीय डायलिंग कोड (जैसे +1, +44, +90) से शुरू नहीं होता है, तो address आवश्यक हो जाता है। इस संदर्भ के बिना, API राष्ट्रीय संख्या स्वरूप की सही व्याख्या नहीं कर सकता।

पता पैरामीटर के साथ उदाहरण:

https://api.genderapi.io/api/phone?key=YOUR_API_KEY&number=12128675309&address=US

प्रतिक्रिया फ़ील्ड

नंबर प्रकार मान

curl "https://api.genderapi.io/api/phone?number=+49 151 12345678&address=United States&key=YOUR_API_KEY"

curl "https://api.genderapi.io/api/phone?number=%2B49%20151%2012345678&address=United%20States&key=YOUR_API_KEY"

POST अनुरोध के माध्यम से फ़ोन सत्यापन API

आप संयुक्त राज्य अमेरिका के लिए फ़ोन नंबर सत्यापित करने हेतु POST विधि का उपयोग कर सकते हैं। बस फ़ोन नंबर को E.164, राष्ट्रीय या अंतर्राष्ट्रीय प्रारूप में देश/पता के साथ प्रदान करें। आपकी API कुंजी को Bearer टोकन के रूप में भेजा जाना चाहिए।

cURL उदाहरण

curl -X POST "https://api.genderapi.io/api/phone" \
  -H "Content-Type: application/json" \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -d '{"number": "+12128675309", "address": "US"}'

PHP cURL उदाहरण

<?php
$url = "https://api.genderapi.io/api/phone";

$data = array(
    "number" => "+12128675309",
    "address" => "US"
);

$payload = json_encode($data);

$ch = curl_init($url);
curl_setopt($ch, CURLOPT_HTTPHEADER, array(
    "Content-Type: application/json",
    "Authorization: Bearer YOUR_API_KEY"
));
curl_setopt($ch, CURLOPT_RETURNTRANSFER, true);
curl_setopt($ch, CURLOPT_POSTFIELDS, $payload);

$response = curl_exec($ch);
curl_close($ch);

echo $response;
?>

JavaScript fetch उदाहरण

fetch("https://api.genderapi.io/api/phone", {
  method: "POST",
  headers: {
    "Content-Type": "application/json",
    "Authorization": "Bearer YOUR_API_KEY"
  },
  body: JSON.stringify({
    number: "+12128675309",
    address: "United States"
  })
})
.then(response => response.json())
.then(data => console.log(data));

Python requests उदाहरण

import requests

url = "https://api.genderapi.io/api/phone"

payload = {
    "number": "+12128675309",
    "address": "United States"
}

headers = {
    "Content-Type": "application/json",
    "Authorization": "Bearer YOUR_API_KEY"
}

response = requests.post(url, headers=headers, json=payload)

print(response.json())

क्लाइंट लाइब्रेरीज़

एकीकरण को और आसान बनाने के लिए, हम विभिन्न प्रोग्रामिंग भाषाओं के लिए आधिकारिक और समुदाय-समर्थित क्लाइंट लाइब्रेरीज़ प्रदान करते हैं। ये लाइब्रेरीज़ आपको GenderAPI एंडपॉइंट्स — जैसे कि Phone Number Validation API — के साथ बातचीत करने देती हैं, बिना मैन्युअली HTTP अनुरोध या JSON पार्सिंग को संभालने की आवश्यकता के। बस अपने पर्यावरण के अनुसार सही लाइब्रेरी चुनें, उसे इंस्टॉल करें, और न्यूनतम सेटअप के साथ अनुरोध भेजना शुरू करें।

उपलब्ध क्लाइंट लाइब्रेरीज़ और इंस्टॉलेशन निर्देशों के लिए निम्न पृष्ठ देखें:
https://www.genderapi.io/hi/docs-client-libraries

अक्सर पूछे जाने वाले प्रश्न (FAQ)

1. Phone Number Validation & Formatter API क्या है?

यह एक टूल है जो आपको दुनिया भर के फ़ोन नंबरों को सत्यापित करने, उनका स्वरूप बदलने और विश्लेषण करने की अनुमति देता है। यह नंबरों को मानकीकृत E.164 स्वरूप में बदल सकता है और क्षेत्र, प्रकार (मोबाइल/लैंडलाइन), वैधता आदि जैसी मेटाडेटा जानकारी प्रदान करता है।

2. फ़ोन नंबर सत्यापन का उपयोग किस लिए किया जाता है?

इसका उपयोग यह जांचने के लिए किया जाता है कि कोई फ़ोन नंबर वैध है या नहीं, उसे अंतरराष्ट्रीय उपयोग के लिए स्वरूपित करने, नंबर का प्रकार पहचानने (जैसे मोबाइल, VoIP), क्षेत्र-आधारित जानकारी पता करने, और CRM, मार्केटिंग टूल या उपयोगकर्ता साइनअप के लिए मानकीकृत नंबर इनपुट सुनिश्चित करने के लिए।

3. कितने देशों को समर्थन प्राप्त है?

API 242 देशों और क्षेत्रों से फ़ोन नंबरों का समर्थन करता है, जिससे किसी भी अंतरराष्ट्रीय या क्षेत्रीय अनुप्रयोग के लिए वैश्विक कवरेज सुनिश्चित होती है।

4. कौन-कौन से स्वरूपों का समर्थन किया जाता है?

API राष्ट्रीय, अंतरराष्ट्रीय या E.164 जैसे विभिन्न स्वरूपों में नंबर स्वीकार करता है। यह उन्हें स्वतः पहचानता है और सही स्वरूप में सामान्यीकृत करता है।

5. अगर मैं देश या पता पैरामीटर छोड़ दूं तो क्या होगा?

यदि फ़ोन नंबर '+' से शुरू नहीं होता और कोई country/address पैरामीटर नहीं दिया गया है, तो API संख्या को सही ढंग से समझने में असमर्थ हो सकता है। address पैरामीटर (जैसे US, United States या New York) देना अनुशंसित है।

6. क्या API नंबर के प्रकार का पता लगा सकता है?

हाँ। API numberType फ़ील्ड लौटाता है जो यह दर्शाता है कि नंबर MOBILE, FIXED_LINE, VOIP आदि है या नहीं।

7. isValid और isPossible में क्या अंतर है?

isValid दर्शाता है कि नंबर आधिकारिक रूप से असाइन किया गया है और सभी क्षेत्रीय नियमों से मेल खाता है। isPossible यह जांचता है कि संरचना के आधार पर नंबर सैद्धांतिक रूप से मौजूद हो सकता है या नहीं, भले ही वह असाइन न हो।

8. API किस प्रकार की प्रतिक्रिया लौटाता है?

एक सफल प्रतिक्रिया में स्थिति, स्वरूपित नंबर संस्करण (राष्ट्रीय, अंतरराष्ट्रीय, E.164), क्षेत्र डेटा, नंबर प्रकार, क्रेडिट उपयोग आदि शामिल होते हैं। पूर्ण आउटपुट उदाहरण के लिए ऊपर दिया गया API Response सेक्शन देखें।

9. मुझे अपनी API कुंजी कैसे भेजनी चाहिए?

GET अनुरोधों के लिए, कुंजी को ?key=YOUR_API_KEY के रूप में जोड़ें। POST अनुरोधों के लिए, हेडर में Bearer टोकन के रूप में उपयोग करें:
"Authorization: Bearer YOUR_API_KEY".

10. अगर मुझे status: false प्रतिक्रिया दिखे तो क्या करें?

इसका मतलब है कि अनुरोध विफल रहा। message फ़ील्ड में त्रुटि का विस्तृत कारण होगा जैसे कि पैरामीटर गायब होना, अमान्य फ़ोन नंबर या अपर्याप्त क्रेडिट।

11. क्या इनपुट में विशेष वर्ण या स्पेस की अनुमति है?

हाँ, लेकिन GET अनुरोधों के लिए उन्हें URL-एन्कोड किया जाना चाहिए। उदाहरण के लिए, स्पेस के बजाय %20 का उपयोग करें। सही उपयोग के लिए ऊपर दी गई चेतावनी अनुभाग देखें।

12. क्या मैं विभिन्न स्वरूपों या भाषाओं में पते का उपयोग कर सकता हूँ?

हाँ। US, DE, TR जैसे ISO 3166-1 alpha-2 कोड के अलावा, address पैरामीटर देश या शहर के पूर्ण नाम — विभिन्न भाषाओं में भी — स्वीकार करता है। API अंतर्निहित AI का उपयोग करके सही देश या क्षेत्र को बुद्धिमानी से पहचानता और समझता है। उदाहरण के लिए:

address=Deutschland
address=États-Unis
address=İstanbul
address=New York
address=Estados Unidos

ये सभी इनपुट बिना किसी समस्या के सही देश या क्षेत्र से मैप हो जाएंगे।