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