बूल्क अनुरोध का आवरण
50 ईमेल पते तक प्रोसेस करें
एक भेजेंdataएक एरे। GenderAPI हर पते से एक संभावित नाम एक्सट्रैक्ट करता है और संबंधित पूर्वानुमान वापस करता है; आपके वैकल्पिकidडेटाबेस के संबंधित निर्धारण को निश्चित करता है।
MethodPOST
Maximum50 ईमेल
Authenticationबीरर टोकन
परिणाम फॉर्मेटnames[]
50 ईमेल max→नाम एक्सट्रैक्शन→देश-समझ वाले परिणाम
HDR
अनिवार्य HTTP हेडर
बल अनुरोध की प्रमाणित करें
Content-Typeapplication/jsonAuthorizationBearer YOUR_API_KEYJSON अनुरोध शरीर
पैरामीटर
| Field | Type | Requirement | Description |
|---|---|---|---|
data | object[] | अनिवार्य | 1 से 50 ईमेल रिकॉर्ड के बीच एक एरे के रूप में |
data[].email | string | अनिवार्य | जिस ईमेल एड्रेस से GenderAPI एक संभावित पहला नाम एक्सट्रैक्ट करता है |
data[].country | string | वैकल्पिक | रीजनल कंटेक्स्ट के लिए ISO 3166-1 alpha-2 देश कोड |
data[].id | string | integer | वैकल्पिक | आपका रिकॉर्ड आइडेंटिफायर, जो अपने संगत परिणाम के साथ अपरिवर्तित रूप से वापस दिया जाता है |
रिकॉर्ड मेल खाता
एक अनुनाद उपयोग करेंidप्रत्येक वस्तु के लिए। GenderAPI उस वस्तु के परिणाम के साथ इसे वापस करता है, जिससे आप बिना अनुच्छेद स्थिति पर निर्भर किए बिना सही डेटाबेस रिकॉर्ड अपडेट कर सकते हैं।
प्रारंभिक डेटा
ईमेल एरे बनाएं
JSON
{
"data": [
{ "email": "andrea.schmidt@example.com", "country": "DE", "id": "123" },
{ "email": "andrea.rossi@example.it", "country": "IT", "id": "456" },
{ "email": "james.brown@example.com", "country": "US", "id": "789" }
]
}कोड के उदाहरण
बहु-ईमेल अनुरोध भेजें
cURL
curl -X POST "https://api.genderapi.io/api/email/multi/country" \
-H "Content-Type: application/json" \
-H "Authorization: Bearer YOUR_API_KEY" \
-d '{"data":[{"email":"andrea.schmidt@example.com","country":"DE","id":"123"},{"email":"james.brown@example.com","country":"US","id":"789"}]}'JavaScript
const data = [
{ email: "andrea.schmidt@example.com", country: "DE", id: "123" },
{ email: "james.brown@example.com", country: "US", id: "789" }
];
const response = await fetch("https://api.genderapi.io/api/email/multi/country", {
method: "POST", headers: { "Content-Type": "application/json", "Authorization": "Bearer YOUR_API_KEY" },
body: JSON.stringify({ data })
});200 प्रतिक्रिया
अपनाए गए नाम और पूर्वानुमान
JSON
{
"status": true, "used_credits": 3, "remaining_credits": 7265,
"expires": 1717069765,
"names": [
{ "name": "Andrea", "q": "andrea.schmidt@example.com", "gender": "female", "country": "DE", "total_names": 644, "probability": 88, "id": "123" },
{ "name": "James", "q": "james.brown@example.com", "gender": "male", "country": "US", "total_names": 45274, "probability": 100, "id": "789" }
], "duration": "5ms"
}प्रतिक्रिया क्षेत्र
| Field | Type | Description |
|---|---|---|
status | boolean | बल्क रिक्वेस्ट के सफल रूप से पूरा होने की जांच |
used_credits | integer | सभ दावा किए गए ईमेल्स के लिए उपयोग किए गए क्रेडिट्स। |
remaining_credits | integer | अनुरोध के बाद उपलब्ध क्रेडिट्स। |
expires | integer | पैकेज के अवधि का समय एक यूनिक्स टाइमस्टाम्प के रूप में। |
names | object[] | दावा किए गए ईमेल्स के लिए परिणामों का आदेशित संग्रह। |
names[].name | string | ईमेल पते से पहले नाम एक्सट्रैक्ट किया गया। |
names[].q | string | अनुरोध में दिए गए मूल ईमेल। |
names[].gender | string | null | पूर्वानुमानित मान: पुरुष, महिला या शून्य। |
names[].country | string | इस परिणाम के लिए धारण किए गए देश का कोड। |
names[].total_names | integer | इस नतीजे के लिए समर्थन देने वाले नमूनों की संख्या |
names[].probability | integer | पूर्वानुमान के विश्वास के प्रतिशत में |
names[].id | string | integer | रिकॉर्ड संबंधित करने के लिए लौटाया गया इनपुट पहचानकर्ता |
duration | string | सर्वर प्रसंस्करण समय की कुल दुरी |
प्रत्येक अनुरोध के लिए 50 रिकॉर्ड तक के अंदर रखें
प्रत्येक पता की जाँच करें और बड़े डेटासेट को 50 के बराबर बैच में विभाजित करें। निकाले गए के पहले नतीजे की जाँच करेंname and probabilityपरिणाम लागू करने से पहले
अगला गाइड