استنتاج الجنس من ما يصل إلى 50 اسم مستخدم

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

معالجة أقصى 50 اسمًا مستخدمًا

أرسلdataمصفوفة. تُحلل GenderAPI إشارات الاسم المحتملة من كل يد وتحصل على نتائج مع سجلك الاختياريid.

MethodPOST

Maximum50 اسمًا مستخدمًا

Authenticationرمز تأكيد Bearer

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

يجب مراجعة نتائج الاسم الجماعي بعناية.

قد تحتوي اليد على علامات تجارية أو مصطلحات تخيلية أو كلمات غير متعلقة. لا تقبل الطلبات الجماعيةaskToAI or forceToGenderize. لمعالجة المدخلات غير المعتادة بثقة أكبر، استخدمالطلب الواحد.

HDR

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

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

Content-Typeapplication/json

AuthorizationBearer YOUR_API_KEY

جسم الطلب JSON

المسامات

Field	Type	Requirement	Description
`data`	object[]	مطلوب	مصفوفة تحتوي بين 1 و50 سجلًا لعناوين المستخدمين.
`data[].username`	string	مطلوب	اسم المستخدم أو الحساب الذي يُحلّل؛ يُسمح باستخدام الرموز والارقام.
`data[].country`	string	اختياري	رمز الدولة حسب معيار ISO 3166-1 alpha-2، يستخدم كسياق جغرافي.
`data[].id`	string \| integer	اختياري	معرّفك، يُعاد دون تغيير مع النتيجة المقابلة.

إرشادات المدخلات

يُعدّ الأسماء المكتوبة بحروف لاتينية عادةً أكثر وضوحًا في إرسال إشارات الاسم. استخدم قيمًا فريدة وقم بتقييم القيم المُستخرجة قبل تحديث السجلات.idالقيمname and probabilityقبل تحديث السجلات.

محتوى الطلب

بناء مصفوفة الاسم المستخدم

JSON

{
  "data": [
    { "username": "anna_smith88", "country": "US", "id": "123" },
    { "username": "michael_bauer", "country": "DE", "id": "456" },
    { "username": "giulia_rossi", "country": "IT", "id": "789" }
  ]
}

أمثلة على الكود

إرسال طلب يحتوي على أسماء مستخدم متعددة

cURL

curl -X POST "https://api.genderapi.io/api/username/multi/country" \
  -H "Content-Type: application/json" \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -d '{"data":[{"username":"anna_smith88","country":"US","id":"123"},{"username":"michael_bauer","country":"DE","id":"456"}]}'

JavaScript

const data = [
  { username: "anna_smith88", country: "US", id: "123" },
  { username: "michael_bauer", country: "DE", id: "456" }
];
const response = await fetch("https://api.genderapi.io/api/username/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": "Anna", "q": "anna_smith88", "gender": "female", "country": "US", "total_names": 1234, "probability": 92, "id": "123" },
    { "name": "Michael", "q": "michael_bauer", "gender": "male", "country": "DE", "total_names": 5678, "probability": 89, "id": "456" }
  ], "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 سجلًا

قسّم المدخلات الكبيرة إلى مجموعات. يكون الاسم مُشيرًا غير مباشر، لذا تحقق من اسم المُستخرج وحدد حدًا احتماليًا مقبولًا قبل تطبيق النتائج.

المرجع التالي

تحقق وصيغ الأرقام الهاتفية

تحقق من رقم الهاتفراجع طرق التحقق والصياغة →Username الطلب الواحدUse خيارات الذكاء الاصطناعي for one handle →