[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
Authorization: Bearer <το διακριτικό εξουσιοδότησής σας>
|
||||||||||||||||||||||||
| JSON Payload |
|
Παραδείγματα
Αναζήτηση μόνο με πλήρες όνομα
{"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.