[API Docs Unified API] v2.0

[API] v1.0

Προσφέρουμε επίσης μία άλλη έκδοση API με endpoints που είναι ευκολότερα στην ενσωμάτωση. Αν είσαι αρχάριος στην υλοποίηση API, μπορείς να αλλάξεις στο endpoint v1.0.

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

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

Αποστολή
Απαιτούμενα αιτήματα: 1
URL
https://gender-api.io/v2/gender
Headers
Content-Type: application/json
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 στη βάση δεδομένων σου. Σε ένα ασύγχρονο περιβάλλον αυτό μπορεί να σε βοηθήσει να συνδέσεις καλύτερα την απάντηση με μια προηγούμενη αίτηση

Παραδείγματα

Αναζήτηση μόνο με πλήρες όνομα
{"full_name":"Theresa Miller"}
Αναζήτηση με πλήρες όνομα και κωδικό χώρας
{"full_name":"Theresa Miller","country":"US"}
Αναζήτηση με πλήρες όνομα και γλώσσα περιηγητή
{"full_name":"Thomas Johnson","locale":"en_US"}
Αναζήτηση με πλήρες όνομα και χρήση διεύθυνσης IP για εντοπισμό
{"full_name":"Markus Stefan NonExistingLastName","ip":"54.201.16.177"}
Αναζήτηση πολλαπλών ονομάτων σε ένα αίτημα
[{"full_name":"Theresa Miller"},{"full_name":"Thomas Johnson","country":"US"}]
Απάντηση
{
    "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"
}
Πεδίο Τύπος Περιγραφή
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
This product includes GeoLite2 data created by MaxMind, available from http://www.maxmind.com.
Συνομιλία