[API Docs Unified API] v2.0

[API] v1.0

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

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

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

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

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

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