⚡ Ενοποιημένο API v2.0 ΠΡΟΧΩΡΗΜΕΝΟ

ΤΕΚΜΗΡΙΩΣΗ API

Δοκίμασε το υψηλής απόδοσης ενοποιημένο API μας, σχεδιασμένο για προχωρημένους χρήστες με μεγάλο όγκο αιτημάτων. Κάνε ερώτημα για πολλαπλά ονόματα σε ένα μόνο αίτημα με αστραπιαίους χρόνους απόκρισης.

Αναζήτηση με πλήρες όνομα - ΔΙΑΧΩΡΙΣΜΟΣ ΟΝΟΜΑΤΟΣ ΚΑΙ ΕΠΩΝΥΜΟΥ

Αν χρησιμοποιείς ένα συνδυασμένο πεδίο για το όνομα και το επώνυμο στη σελίδα σου, χρησιμοποίησε αυτό το API για να εξαγάγεις τα μέρη:

POST https://gender-api.com/v2/gender

info Απαιτούμενα αιτήματα: 1

http Headers

Content-Type: application/json

Authorization: Bearer <το διακριτικό εξουσιοδότησής σας>

link

data_object JSON Payload

Πεδίο	Τύπος	Υποχρεωτικό	Περιγραφή
`full_name`	string	Ναι	Όνομα για αναζήτηση
`country`	string	Όχι	Κωδικός Χώρας ISO 3166 ALPHA-2 link
`locale`	string	Όχι	Τοπική διαμόρφωση προγράμματος περιήγησης
`ip`	string	Όχι	Έγκυρη διεύθυνση IPv4 ή IPv6
`id`	string	Όχι	Μέγιστος αριθμός χαρακτήρων: 50. Μπορείς να ορίσεις αυτό το id σε οποιαδήποτε αλφαριθμητική τιμή θέλεις. Ως παράδειγμα, μπορείς να ορίσεις το id στο εσωτερικό id του dataset στη βάση δεδομένων σου. Σε ένα ασύγχρονο περιβάλλον αυτό μπορεί να σε βοηθήσει να συνδέσεις καλύτερα την απάντηση με μια προηγούμενη αίτηση

code Request Examples

arrow_forward Αναζήτηση μόνο με πλήρες όνομα

play_arrow Try Live On Codepen.io

{
    "full_name": "Theresa Miller"
}

arrow_forward Αναζήτηση με πλήρες όνομα και κωδικό χώρας

play_arrow Try Live On Codepen.io

{
    "full_name": "Theresa Miller",
    "country": "US"
}

arrow_forward Αναζήτηση με πλήρες όνομα και γλώσσα περιηγητή

play_arrow Try Live On Codepen.io

{
    "full_name": "Thomas Johnson",
    "locale": "en_US"
}

arrow_forward Αναζήτηση με πλήρες όνομα και χρήση διεύθυνσης IP για εντοπισμό

play_arrow Try Live On Codepen.io

{
    "full_name": "Markus Stefan NonExistingLastName",
    "ip": "54.201.16.177"
}

arrow_forward Αναζήτηση πολλαπλών ονομάτων σε ένα αίτημα

play_arrow Try Live On Codepen.io

[
    {
        "full_name": "Theresa Miller"
    },
    {
        "full_name": "Thomas Johnson",
        "country": "US"
    }
]

check_circle Απάντηση

{
    "input": {
        "full_name": "Theresa Miller"
    },
    "details": {
    "credits_used": 1,
        "duration": "33ms",
        "samples": 8961,
        "country": null,
        "first_name_sanitized": "theresa"
    },
    "result_found": true,
    "last_name": "Miller",
    "first_name": "Theresa",
    "probability": 0.98,
    "gender": "female"
}

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

Πεδίο	Τύπος	Περιγραφή
`input`	object	Το υποβληθέν φορτίο
`details.credits_used`	int	Η ποσότητα αιτημάτων που χρησιμοποιήθηκαν για αυτό το ερώτημα
`details.samples`	int	Αριθμός εγγραφών που βρέθηκαν στη βάση δεδομένων μας και ταιριάζουν με το αίτημά σου
`details.country`	string	Η χώρα που βρήκαμε
`details.full_name_sanitized`	int	Το όνομα μετά την εφαρμογή του κανονικοποιητή μας
`details.duration`	string	Χρόνος που χρειάστηκε ο διακομιστής για να επεξεργαστεί το αίτημα
`result_found`	bool	Αληθές αν μπορέσαμε να προσδιορίσουμε το φύλο για το συγκεκριμένο όνομα
`full_name`	string	Το πλήρες όνομα που χρησιμοποιήσαμε για τον προσδιορισμό του φύλου
`probability`	float	Αυτή η τιμή (μεταξύ 0 και 1) καθορίζει την αξιοπιστία της βάσης δεδομένων μας. Μια τιμή 1 σημαίνει ότι τα αποτελέσματα στο αίτημά σου για το φύλο είναι 100% ακριβή.
`gender`	string	Πιθανές τιμές: male, female, unknown