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

ΤΕΚΜΗΡΙΩΣΗ API

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

Ερώτηση με μικρό όνομα

Αυτός είναι ο ευκολότερος τρόπος να αναζητήσεις φύλο βάσει ονόματος. Κάθε απάντηση είναι κωδικοποιημένη σε JSON:

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

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

http Headers

Content-Type: application/json

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

link

data_object JSON Payload

Πεδίο	Τύπος	Υποχρεωτικό	Περιγραφή
`first_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

{
    "first_name": "Sandra"
}

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

play_arrow Try Live On Codepen.io

{
    "first_name": "Sandra",
    "country": "US"
}

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

play_arrow Try Live On Codepen.io

{
    "first_name": "Sandra",
    "locale": "en_US"
}

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

play_arrow Try Live On Codepen.io

{
    "first_name": "Sandra",
    "ip": "54.201.16.177"
}

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

play_arrow Try Live On Codepen.io

[
    {
        "first_name": "Sandra",
        "country": "US"
    },
    {
        "first_name": "Jason",
        "country": "US"
    }
]

check_circle Απάντηση

{
    "input": {
        "first_name": "Sandra"
    },
    "details": {
        "credits_used": 1,
        "samples": 464,
        "country": null,
        "first_name_sanitized": "sandra",
        "duration": "436ms"
    },
    "result_found": true,
    "first_name": "Sandra",
    "probability": 0.85,
    "gender": "female"
}

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

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