Μαζικό GenderAPI από Όνομα – Πολλαπλό Αίτημα

Επισκόπηση μαζικού αιτήματος

Επεξεργαστείτε έως 100 ονόματα

Στείλτε έναν πίνακα data και λάβετε ένα αποτέλεσμα ανά εγγραφή. Προσθέστε το δικό σας id για αξιόπιστη σύνδεση κάθε πρόβλεψης με την αρχική εγγραφή.

ΜέθοδοςPOST

Μέγιστο100 ονόματα

Έλεγχος ταυτότηταςBearer token

AI fallbackΔεν υποστηρίζεται

Τα μαζικά αιτήματα δεν χρησιμοποιούν AI inference.

Τα askToAI και forceToGenderize δεν είναι διαθέσιμα. Για μη λατινικές γραφές ή AI fallback, χρησιμοποιήστε το endpoint μεμονωμένου ονόματος.

HDR

Απαιτούμενα HTTP headers

Πιστοποιήστε το μαζικό αίτημα

Content-Typeapplication/json

AuthorizationBearer YOUR_API_KEY

Σώμα αιτήματος JSON

Παράμετροι

Πεδίο	Τύπος	Απαίτηση	Περιγραφή
`data`	object[]	Απαιτείται	Πίνακας που περιέχει από 1 έως 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.

Payload αιτήματος

Δημιουργήστε τον πίνακα 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	Συνολικός χρόνος επεξεργασίας στον server.

Διατηρήστε κάθε αίτημα εντός 100 εγγραφών

Επικυρώστε τον πίνακα πριν την αποστολή και χρησιμοποιήστε μοναδικό id για σαφή αντιστοίχιση. Χωρίστε μεγαλύτερα σύνολα σε παρτίδες έως 100 ονομάτων.

Επόμενος οδηγός

Προσδιορίστε φύλο από email

Μεμονωμένο αίτημα emailΕξαγάγετε και αναλύστε όνομα από email →Μεμονωμένο αίτημα ονόματοςΧρησιμοποιήστε AI fallback για ένα όνομα →