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

ΤΕΚΜΗΡΙΩΣΗ API

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

Αναζήτηση μέσω διεύθυνσης email

Μπορείς επίσης να αναζητήσεις ένα φύλο χρησιμοποιώντας μια διεύθυνση email που περιέχει μια διεύθυνση email:

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

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

http Headers

Content-Type: application/json

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

link

data_object JSON Payload

Πεδίο	Τύπος	Υποχρεωτικό	Περιγραφή
`email`	string	Ναι	Διεύθυνση email για ερώτημα
`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 Αναζήτηση μόνο με διεύθυνση email

play_arrow Try Live On Codepen.io

{
    "email": "theresa.miller14@gmail.com"
}

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

play_arrow Try Live On Codepen.io

{
    "email": "thomas.clarks@hotmail.com",
    "country": "US"
}

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

play_arrow Try Live On Codepen.io

{
    "email": "Thomas.j32@live.com",
    "locale": "en_US"
}

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

play_arrow Try Live On Codepen.io

{
    "email": "thomasfromnewyork@gmail.com",
    "ip": "54.201.16.177"
}

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

play_arrow Try Live On Codepen.io

[
    {
        "email": "thomas.clarks@hotmail.com",
        "country": "US"
    },
    {
        "email": "theresa.miller14@gmail.com"
    }
]

check_circle Απάντηση

{
    "input": {
        "email": "theresa.miller14@gmail.com"
    },
    "details": {
        "credits_used": 1,
        "duration": "12ms",
        "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.email_sanitized`	int	Το όνομα μετά την εφαρμογή του κανονικοποιητή μας
`details.duration`	string	Χρόνος που χρειάστηκε ο διακομιστής για να επεξεργαστεί το αίτημα
`result_found`	bool	Αληθές αν μπορέσαμε να προσδιορίσουμε το φύλο για το συγκεκριμένο όνομα
`email`	string	Η διεύθυνση email που χρησιμοποιήσαμε για τον προσδιορισμό του φύλου
`probability`	float	Αυτή η τιμή (μεταξύ 0 και 1) καθορίζει την αξιοπιστία της βάσης δεδομένων μας. Μια τιμή 1 σημαίνει ότι τα αποτελέσματα στο αίτημά σου για το φύλο είναι 100% ακριβή.
`gender`	string	Πιθανές τιμές: male, female, unknown