Λήψη Φύλου από Όνομα - Πολλαπλά Αιτήματα

Το endpoint Multiple Names σας επιτρέπει να αναλύσετε το φύλο έως και 100 ονομάτων σε ένα μόνο αίτημα. Αυτό είναι χρήσιμο για μαζική επεξεργασία και για υψηλής απόδοσης ενσωματώσεις. Όλες οι παράμετροι αποστέλλονται με αίτημα POST ως JSON. Πρέπει να κάνετε αυθεντικοποίηση με μέθοδο Bearer token στην κεφαλίδα Authorization.

Προσθέτοντας το φίλτρο country σε κάθε όνομα, μπορείτε να λάβετε προβλέψεις φύλου ειδικά για μια συγκεκριμένη χώρα. Αν δεν υπάρχει αποτέλεσμα για τη δεδομένη χώρα, το API θα δώσει ένα παγκόσμιο αποτέλεσμα για το όνομα.

Μπορείτε επίσης να δώσετε ένα προαιρετικό πεδίο id για κάθε όνομα. Αυτή η τιμή μπορεί να είναι οποιαδήποτε συμβολοσειρά ή ακέραιος από τη δική σας βάση δεδομένων. Το API θα επιστρέψει το ίδιο id στην απάντηση, ώστε να αντιστοιχίσετε τα δεδομένα σας με τα αποτελέσματα.

URL Αιτήματος

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

Πεδία Απόκρισης