नाम से लिंग प्राप्त करें - मल्टीपल रिक्वेस्ट
Multiple Names एंडपॉइंट आपको एक ही रिक्वेस्ट में अधिकतम 100 नामों का लिंग एनालाइज़ करने की सुविधा देता है। यह बल्क प्रोसेसिंग और हाई-परफॉर्मेंस इंटीग्रेशन के लिए उपयोगी है। सभी पैरामीटर एक POST रिक्वेस्ट के जरिए JSON के रूप में भेजे जाते हैं। आपको Authorization हेडर में Bearer टोकन विधि का उपयोग करके प्रमाणित करना होगा।
प्रत्येक नाम में country
फ़िल्टर जोड़कर, आप किसी विशेष देश के लिए लिंग की भविष्यवाणी प्राप्त कर सकते हैं।
यदि दिए गए देश के लिए कोई परिणाम नहीं मिलता है, तो API वैश्विक नाम परिणाम लौटाएगा।
आप प्रत्येक नाम के लिए एक वैकल्पिक id
फ़ील्ड भी भेज सकते हैं। यह वैल्यू आपकी खुद की डेटाबेस से कोई भी स्ट्रिंग या नंबर हो सकता है।
API उसी id
को रिस्पॉन्स में लौटाएगा, जिससे आप अपनी इनपुट को परिणामों से मैच कर सकते हैं।
askToAI
जैसे पैरामीटर बल्क ऑपरेशंस में उपलब्ध नहीं हैं।यदि आपके डेटा में अक्सर गैर-लैटिन वर्णों (जैसे चीनी) में नाम होते हैं, तो हम सिंगल रिक्वेस्ट भेजने और
askToAI
पैरामीटर का उपयोग करने की सलाह देते हैं ताकि अधिक सटीक परिणाम मिलें।
रिक्वेस्ट URL
POST https://api.genderapi.io/api/name/multi/country
आवश्यक HTTP हेडर
Content-Type: application/json
Authorization: Bearer YOUR_API_KEY
रिक्वेस्ट बॉडी पैरामीटर
फ़ील्ड | टाइप | आवश्यक | विवरण |
---|---|---|---|
data | ऑब्जेक्ट्स की सूची (Array) | हाँ | नामों और उनके वैकल्पिक पैरामीटर की सूची। प्रति रिक्वेस्ट अधिकतम 100 एंट्री। |
name | String | हाँ (प्रत्येक ऑब्जेक्ट में) | जिस नाम का लिंग आप जानना चाहते हैं। |
country | String | नहीं |
दो-अक्षरों का देश कोड (ISO 3166-1 alpha-2) भविष्यवाणी की सटीकता बढ़ाने के लिए। उदाहरण: TR तुर्की के लिए।
|
id | String या Integer | नहीं |
वैकल्पिक ID जिसे आप अपने डेटाबेस रिकॉर्ड से मैच करने के लिए परिभाषित करते हैं।
वही id रिस्पॉन्स में लौटाई जाती है।
|
रिक्वेस्ट बॉडी उदाहरण
{
"data": [
{ "name": "Andrea", "country": "DE", "id": "123" },
{ "name": "andrea", "country": "IT", "id": "456" },
{ "name": "james", "country": "US", "id": "789" }
]
}
रिक्वेस्ट के उदाहरण
cURL उदाहरण
curl -X POST "https://api.genderapi.io/api/name/multi/country" \
-H "Content-Type: application/json" \
-H "Authorization: Bearer YOUR_API_KEY" \
-d '{"data":[{"name":"Andrea","country":"DE","id":"123"},{"name":"andrea","country":"IT","id":"456"},{"name":"james","country":"US","id":"789"}]}'
PHP cURL उदाहरण
<?php
$url = "https://api.genderapi.io/api/name/multi/country";
$data = array(
"data" => array(
array(
"name" => "Andrea",
"country" => "DE",
"id" => "123"
),
array(
"name" => "andrea",
"country" => "IT",
"id" => "456"
),
array(
"name" => "james",
"country" => "US",
"id" => "789"
)
)
);
$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/name/multi/country", {
method: "POST",
headers: {
"Content-Type": "application/json",
"Authorization": "Bearer YOUR_API_KEY"
},
body: JSON.stringify({
data: [
{ name: "Andrea", country: "DE", id: "123" },
{ name: "andrea", country: "IT", id: "456" },
{ name: "james", country: "US", id: "789" }
]
})
})
.then(response => response.json())
.then(data => console.log(data));
Python requests उदाहरण
import requests
url = "https://api.genderapi.io/api/name/multi/country"
payload = {
"data": [
{ "name": "Andrea", "country": "DE", "id": "123" },
{ "name": "andrea", "country": "IT", "id": "456" },
{ "name": "james", "country": "US", "id": "789" }
]
}
headers = {
"Content-Type": "application/json",
"Authorization": "Bearer YOUR_API_KEY"
}
response = requests.post(url, headers=headers, json=payload)
print(response.json())
JSON रिस्पॉन्स उदाहरण
{
"status": true,
"used_credits": 3,
"remaining_credits": 7265,
"expires": 1717069765,
"names": [
{
"name": "andrea",
"q": "Andrea",
"gender": "female",
"country": "DE",
"total_names": 644,
"probability": 88,
"id": "optional"
},
{
"name": "andrea",
"q": "andrea",
"gender": "male",
"country": "IT",
"total_names": 13537,
"probability": 98,
"id": "optional"
},
{
"name": "james",
"q": "james",
"gender": "male",
"country": "US",
"total_names": 45274,
"probability": 100,
"id": "optional"
}
],
"duration": "5ms"
}
रिस्पॉन्स फ़ील्ड्स
फ़ील्ड | टाइप | विवरण |
---|---|---|
status | Boolean | क्या रिक्वेस्ट सफल रही या नहीं यह दर्शाता है। |
used_credits | Integer | इस रिक्वेस्ट के लिए उपयोग किए गए क्रेडिट्स की संख्या। |
remaining_credits | Integer | रिक्वेस्ट के बाद आपके खाते में बचे हुए क्रेडिट्स। |
expires | Integer (timestamp) | आपके पैकेज की समाप्ति तिथि UNIX टाइमस्टैम्प के रूप में। |
names | ऑब्जेक्ट्स की सूची | हर इनपुट नाम के लिए परिणामों की सूची। |
names[].name | String | नाम का सामान्यीकृत (लोअरकेस) संस्करण। |
names[].q | String | आपकी ओर से भेजा गया ओरिजिनल क्वेरी (केस-सेंसिटिव)। |
names[].gender | Enum[String] | अनुमानित लिंग: male , female या null । |
names[].country | String | भविष्यवाणी के दौरान विचार किया गया देश कोड। |
names[].total_names | Integer | इस भविष्यवाणी के लिए उपयोग किए गए सैंपलों की संख्या। |
names[].probability | Integer | लिंग भविष्यवाणी के लिए विश्वास प्रतिशत। |
names[].id | String / Integer | वही id जो आपने रिक्वेस्ट में भेजी थी। आपके रिकॉर्ड्स को मैच करने के लिए। |
duration | String | रिक्वेस्ट प्रोसेसिंग में लगा कुल समय (जैसे 5ms )। |
id
फ़ील्ड का उपयोग करें।