GenderAPI από Όνομα – Τεκμηρίωση Μεμονωμένου Αιτήματος

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

Στείλτε ένα όνομα ανά αίτημα

Υποβάλετε ένα αντικείμενο JSON με όνομα και πιστοποιήστε το αίτημα με Bearer token. Προσθέστε κωδικό χώρας όταν τα τοπικά μοτίβα ονομάτων μπορούν να βελτιώσουν την πρόβλεψη.

ΜέθοδοςPOST

Τύπος περιεχομένουapplication/json

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

Κόστος1 αναζήτηση

HDR

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

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

Content-Typeapplication/json

AuthorizationBearer YOUR_API_KEY

Διατηρείτε το κλειδί API σε server-side μεταβλητές περιβάλλοντος. Δείτε τον οδηγό ελέγχου ταυτότητας για ασφαλή διαχείριση διαπιστευτηρίων.

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

Παράμετροι

Παράμετρος	Τύπος	Απαίτηση	Περιγραφή
`name`	string	Απαιτείται	Το όνομα που θα αναλυθεί. Χρησιμοποιήστε καθαρή τιμή χωρίς τίτλους ή προσφωνήσεις.
`country`	string	Προαιρετικό	Κωδικός χώρας ISO 3166-1 alpha-2, όπως US ή GR, για προσθήκη γεωγραφικού πλαισίου.
`askToAI`	boolean	Προαιρετικό	Όταν είναι true, χρησιμοποιείται εφεδρική ανάλυση AI αν το όνομα δεν βρεθεί στη βάση δεδομένων.
`forceToGenderize`	boolean	Προαιρετικό	Όταν είναι true, επιχειρείται αποτέλεσμα για ψευδώνυμα ή τιμές που δεν μοιάζουν με συνηθισμένα ονόματα.

Σχετικά με την εφεδρική ανάλυση AI

Το askToAI εφαρμόζεται μόνο όταν η βάση δεδομένων δεν επιστρέφει αποτέλεσμα. Οι εξαναγκασμένες προβλέψεις για ασυνήθιστες τιμές μπορεί να είναι λιγότερο αξιόπιστες· αξιολογείτε πάντα το probability.

Παραδείγματα κώδικα

Στείλτε ένα μεμονωμένο αίτημα

Τα παραδείγματα στέλνουν το ίδιο αίτημα με Bearer authentication.

cURL

curl -X POST "https://api.genderapi.io/api" \
  -H "Content-Type: application/json" \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -d '{"name":"Alice","country":"US","askToAI":true}'

JavaScript

const response = await fetch("https://api.genderapi.io/api", {
  method: "POST",
  headers: {
    "Content-Type": "application/json",
    "Authorization": "Bearer YOUR_API_KEY"
  },
  body: JSON.stringify({ name: "Alice", country: "US", askToAI: true })
});

const data = await response.json();

Python

import requests

response = requests.post(
  "https://api.genderapi.io/api",
  headers={"Authorization": "Bearer YOUR_API_KEY"},
  json={"name": "Alice", "country": "US", "askToAI": True}
)
print(response.json())

Απόκριση 200

Αποτέλεσμα πρόβλεψης

JSON

{
  "status": true,
  "used_credits": 1,
  "remaining_credits": 4999,
  "expires": 1743659200,
  "q": "Alice",
  "name": "Alice",
  "gender": "female",
  "country": "US",
  "total_names": 10234,
  "probability": 98,
  "duration": "4ms"
}

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

Πεδίο	Τύπος	Περιγραφή
`status`	boolean	Δηλώνει αν το αίτημα ολοκληρώθηκε επιτυχώς.
`used_credits`	integer	Μονάδες που καταναλώθηκαν από το αίτημα.
`remaining_credits`	integer	Διαθέσιμες μονάδες μετά το αίτημα.
`expires`	integer	Χρόνος λήξης πακέτου ως UNIX timestamp.
`q`	string	Το αρχικό όνομα που υποβλήθηκε.
`name`	string	Το όνομα που ανέλυσε το GenderAPI.
`gender`	string \| null	Προβλεπόμενη τιμή: male, female ή null.
`country`	string	Κωδικός χώρας που λήφθηκε υπόψη στην πρόβλεψη.
`total_names`	integer	Πλήθος δειγμάτων που υποστηρίζουν την πρόβλεψη.
`probability`	integer	Βεβαιότητα πρόβλεψης ως ποσοστό.
`duration`	string	Χρόνος επεξεργασίας στον server.

Στείλτε καθαρά και σωστά κωδικοποιημένα δεδομένα

Χρησιμοποιήστε όνομα χωρίς τίτλους ή προσφωνήσεις. Οι JSON clients χειρίζονται αυτόματα την κωδικοποίηση, αλλά να επικυρώνετε πάντα εξωτερικά δεδομένα πριν δημιουργήσετε το σώμα του αιτήματος.

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

Αναλύστε πολλά ονόματα

Μαζικό αίτημα ονομάτωνΕπεξεργαστείτε πολλά ονόματα σε ένα αίτημα →Έλεγχος ταυτότηταςΕλέγξτε ξανά την ασφάλεια του κλειδιού API →