تحديد الجنس من إلى 50 عنوان بريد إلكتروني

ملخص الطلب الجماعي

معالجة ما يصل إلى 50 عنوان بريد إلكتروني

أرسلdataمصفوفة. تُستخرج GenderAPI اسمًا محتملًا من كل عنوان وتعيد التنبؤ المناسب؛ وتمكّنك الخياريidمن تأكيد التوافق مع قاعدة البيانات.

MethodPOST

Maximum50 بريد إلكتروني

Authenticationرمز تأكيد

صيغة النتيجةnames[]

50 بريد إلكتروني maxاستخراج الاسمالنتائج المُحسَّنة حسب الدولة

HDR

الرؤوس المطلوبة لـ HTTP

إذن الطلب الجماعي

Content-Typeapplication/json

AuthorizationBearer YOUR_API_KEY

جسم الطلب بصيغة JSON

المسامات

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	وقت انتهاء الحزمة كزمن UNIX.
`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قبل تطبيق النتيجة.

الدليل التالي

تحديد الجنس من اسم المستخدم

طلب واحد لاسم المستخدماستخراج اسم من اسم مستخدم واحد →طلب واحد لعنوان البريد الإلكترونياستخدام الـ AI كمُستبدل لبريد إلكتروني واحد →