Λήψη Φύλου μέσω Ονόματος Χρήστη – Πολλαπλά Αιτήματα

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

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

Προειδοποίηση: Τα ονόματα χρήστη απαιτείται συνήθως να είναι σε λατινικούς χαρακτήρες. Ωστόσο, συχνά περιλαμβάνουν λέξεις ή συνδυασμούς που δεν αντιπροσωπεύουν πραγματικά ονόματα, π.χ. cool_boy123.

Αν ο κύριος στόχος σας είναι η ακριβής πρόβλεψη φύλου, συνιστούμε να χρησιμοποιήσετε μονά αιτήματα με ενεργοποιημένη την παράμετρο forceToGenderize.

Αν η προτεραιότητά σας είναι απλώς η εξαγωγή πιθανών ονομάτων από ονόματα χρήστη, μπορείτε να χρησιμοποιήσετε τα πολλαπλά αιτήματα αντί αυτού.

Διεύθυνση URL Αιτήματος

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

Απαραίτητες HTTP Κεφαλίδες

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

Παράμετροι Σώματος Αιτήματος

Πεδίο Τύπος Απαιτείται Περιγραφή
data Πίνακας αντικειμένων Ναι Πίνακας ονομάτων χρήστη και των προαιρετικών παραμέτρων τους. Μέγιστο 50 εγγραφές ανά αίτημα.
username String Ναι (σε κάθε αντικείμενο) Το όνομα χρήστη που θέλετε να αναλύσετε. Μπορεί να περιλαμβάνει underscores, αριθμούς κ.ά.
country String Όχι Διγράμματος κωδικός χώρας (ISO 3166-1 alpha-2) για βελτίωση της ακρίβειας πρόβλεψης. Παράδειγμα: TR για Τουρκία.
id String ή Integer Όχι Προαιρετικό ID που ορίζετε ώστε να ταιριάξετε τα αποτελέσματα με τις δικές σας εγγραφές βάσης δεδομένων. Το ίδιο id θα επιστραφεί στην απόκριση για σκοπούς αντιστοίχισης.

Παράδειγμα Σώματος Αιτήματος

{
  "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"},{"username":"giulia_rossi","country":"IT","id":"789"}]}'

Παράδειγμα PHP cURL

<?php
$url = "https://api.genderapi.io/api/username/multi/country";

$data = array(
    "data" => array(
        array(
            "username" => "anna_smith88",
            "country" => "US",
            "id" => "123"
        ),
        array(
            "username" => "michael_bauer",
            "country" => "DE",
            "id" => "456"
        ),
        array(
            "username" => "giulia_rossi",
            "country" => "IT",
            "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/username/multi/country", {
  method: "POST",
  headers: {
    "Content-Type": "application/json",
    "Authorization": "Bearer YOUR_API_KEY"
  },
  body: JSON.stringify({
    data: [
      { username: "anna_smith88", country: "US", id: "123" },
      { username: "michael_bauer", country: "DE", id: "456" },
      { username: "giulia_rossi", country: "IT", id: "789" }
    ]
  })
})
.then(response => response.json())
.then(data => console.log(data));

Παράδειγμα Python requests

import requests

url = "https://api.genderapi.io/api/username/multi/country"

payload = {
    "data": [
        { "username": "anna_smith88", "country": "US", "id": "123" },
        { "username": "michael_bauer", "country": "DE", "id": "456" },
        { "username": "giulia_rossi", "country": "IT", "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": "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"
    },
    {
      "name": "Giulia",
      "q": "giulia_rossi",
      "gender": "female",
      "country": "IT",
      "total_names": 4321,
      "probability": 95,
      "id": "789"
    }
  ],
  "duration": "5ms"
}

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

Πεδίο Τύπος Περιγραφή
status Boolean Δείχνει αν το αίτημα ήταν επιτυχές.
used_credits Integer Πλήθος πόντων που χρησιμοποιήθηκαν για αυτό το αίτημα.
remaining_credits Integer Πόντοι που απομένουν στον λογαριασμό σας μετά από αυτό το αίτημα.
expires Integer (timestamp) Η ημερομηνία λήξης του πακέτου σε UNIX timestamp.
names Πίνακας αντικειμένων Λίστα αποτελεσμάτων για κάθε εισαχθέν όνομα χρήστη.
names[].name String Το ανιχνευθέν μικρό όνομα, εφόσον υπάρχει, που εξάγεται από το όνομα χρήστη.
names[].q String Το αρχικό όνομα χρήστη που δώσατε ως είσοδο.
names[].gender Enum[String] Το προβλεπόμενο φύλο: male, female ή null.
names[].country String Ο κωδικός χώρας που ελήφθη υπόψη στην πρόβλεψη.
names[].total_names Integer Πλήθος δειγμάτων που χρησιμοποιήθηκαν για την πρόβλεψη.
names[].probability Integer Ποσοστό εμπιστοσύνης στην πρόβλεψη φύλου.
names[].id String / Integer Το ίδιο id που στείλατε στο αίτημα. Χρησιμοποιείται για αντιστοίχιση εγγραφών.
duration String Συνολικός χρόνος επεξεργασίας του αιτήματος (π.χ. 5ms).