تحديد جنس عدة أسماء API | توثيق الطلب المجمع

نظرة عامة على الطلب المجمع

عالج ما يصل إلى 100 اسم

أرسل مصفوفة data لتحصل على نتيجة لكل سجل. أضف id من نظامك كي تربط كل توقع بسجل المصدر بصورة موثوقة.

الطريقةPOST

الحد الأقصى100 اسم

المصادقةBearer token

دعم الذكاء الاصطناعيغير مدعوم

الطلبات المجمعة لا تستخدم استدلال الذكاء الاصطناعي.

المعاملان askToAI وforceToGenderize غير متاحين. للأسماء المكتوبة بأنظمة غير لاتينية أو المدخلات التي تحتاج إلى دعم AI، استخدم endpoint الاسم الواحد.

HDR

ترويسات HTTP المطلوبة

وثّق الطلب المجمع

Content-Typeapplication/json

AuthorizationBearer YOUR_API_KEY

جسم طلب JSON

المعاملات

الحقل	النوع	الحالة	الوصف
`data`	object[]	مطلوب	مصفوفة تحتوي على سجل اسم واحد وحتى 100 سجل.
`data[].name`	string	مطلوب	الاسم الأول المراد تحليله.
`data[].country`	string	اختياري	رمز الدولة ISO 3166-1 alpha-2. تُستخدم النتيجة العالمية عند عدم توفر نتيجة للدولة.
`data[].id`	string \| integer	اختياري	معرّف السجل في نظامك؛ يُعاد دون تغيير لربط النتائج بسجلات الإدخال.

الرجوع إلى النتيجة العالمية

إذا لم توجد مطابقة للدولة المرسلة، تعيد GenderAPI نتيجة الاسم العالمية المتاحة. استخدم قيم ISO 3166-1 alpha-2 مثل DE أو IT أو US.

حمولة الطلب

أنشئ مصفوفة data

JSON

{
  "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"}]}'

JavaScript

const data = [
  { name: "Andrea", country: "DE", id: "123" },
  { name: "andrea", country: "IT", id: "456" }
];

const response = await 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 })
});

استجابة 200

اربط النتائج بسجلاتك

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": "123" },
    { "name": "andrea", "q": "andrea", "gender": "male", "country": "IT", "total_names": 13537, "probability": 98, "id": "456" }
  ],
  "duration": "5ms"
}

حقول الاستجابة

الحقل	النوع	الوصف
`status`	boolean	يوضح ما إذا اكتمل الطلب المجمع بنجاح.
`used_credits`	integer	إجمالي الأرصدة المستهلكة لكل الأسماء المرسلة.
`remaining_credits`	integer	الأرصدة المتبقية بعد الطلب.
`expires`	integer	وقت انتهاء الباقة بصيغة UNIX timestamp.
`names`	object[]	مجموعة مرتبة من نتائج توقع الأسماء.
`names[].name`	string	الاسم الموحّد المستخدم في التوقع.
`names[].q`	string	الاسم الأصلي المرسل في الطلب.
`names[].gender`	string \| null	القيمة المتوقعة: male أو female أو null.
`names[].country`	string	رمز الدولة المستخدم لهذه النتيجة.
`names[].total_names`	integer	عدد العينات الداعمة لهذه النتيجة.
`names[].probability`	integer	درجة الثقة في التوقع كنسبة مئوية.
`names[].id`	string \| integer	معرّف الإدخال المعاد لربط السجلات.
`duration`	string	إجمالي مدة المعالجة على الخادم.

لا تتجاوز 100 سجل في الطلب الواحد

تحقّق من المصفوفة قبل إرسالها واستخدم id فريداً لربط السجلات بصورة حتمية. قسّم مجموعات البيانات الأكبر إلى دفعات لا تتجاوز 100 اسم.

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

حدّد الجنس من بريد إلكتروني

طلب بريد إلكتروني واحداستخرج اسماً من البريد وحلّله ←طلب اسم واحداستخدم دعم AI لاسم واحد ←