تحديد الجنس من الاسم - طلب متعدد

تتيح لك نقطة النهاية الأسماء المتعددة تحليل جنس حتى 100 اسم في طلب واحد. هذا مفيد للمعالجة الجماعية والتكاملات ذات الأداء العالي. يتم إرسال جميع المعلمات عبر طلب POST كـ JSON. يجب عليك المصادقة باستخدام طريقة Bearer token في ترويسة Authorization.

من خلال إضافة عامل التصفية country لكل اسم، يمكنك الحصول على توقعات جنس خاصة بدولة معينة. إذا لم يكن هناك نتيجة للدولة المحددة، ستعيد واجهة برمجة التطبيقات نتيجة عالمية للاسم.

يمكنك أيضًا تمرير حقل id اختياري لكل اسم. يمكن أن تكون هذه القيمة أي سلسلة نصية أو رقمية من قاعدة بياناتك الخاصة. ستقوم واجهة برمجة التطبيقات بإرجاع نفس id في الاستجابة، بحيث يمكنك مطابقة بياناتك مع النتائج.

رابط الطلب

POST https://api.genderapi.io/api/name/multi/country

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

• Content-Type: application/json
• Authorization: Bearer YOUR_API_KEY

معلمات جسم الطلب

مثال على جسم الطلب

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

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