[API Docs Unified API] v2.0
[API] v1.0
Προσφέρουμε επίσης μία άλλη έκδοση API με endpoints που είναι ευκολότερα στην ενσωμάτωση. Αν είσαι αρχάριος στην υλοποίηση API, μπορείς να αλλάξεις στο endpoint v1.0.
Αναζήτηση μέσω διεύθυνσης email
Μπορείς επίσης να αναζητήσεις ένα φύλο χρησιμοποιώντας μια διεύθυνση email που περιέχει μια διεύθυνση email:
Αποστολή
Απαιτούμενα αιτήματα: 1
| URL |
https://gender-api.io/v2/gender
|
||||||||||||||||||||||||
| Headers |
Content-Type: application/json
Authorization: Bearer <το διακριτικό εξουσιοδότησής σας>
|
||||||||||||||||||||||||
| JSON Payload |
|
Παραδείγματα
Αναζήτηση μόνο με διεύθυνση email
{"email":"theresa.miller14@gmail.com"}
Αναζήτηση με διεύθυνση email και κωδικό χώρας
{"email":"thomas.clarks@hotmail.com","country":"US"}
Αναζήτηση με διεύθυνση email και τοπική ρύθμιση προγράμματος περιήγησης
{"email":"Thomas.j32@live.com","locale":"en_US"}
Αναζήτηση με διεύθυνση email και χρήση διεύθυνσης IP για τοπικοποίηση
{"email":"thomasfromnewyork@gmail.com","ip":"54.201.16.177"}
Αναζήτηση πολλαπλών ονομάτων σε ένα αίτημα
[{"email":"thomas.clarks@hotmail.com","country":"US"},{"email":"theresa.miller14@gmail.com"}]
Απάντηση
{
"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"
}
| Πεδίο | Τύπος | Περιγραφή |
|---|---|---|
| input | object | Το υποβληθέν φορτίο |
| details.credits_used | int | Η ποσότητα αιτημάτων που χρησιμοποιήθηκαν για αυτό το ερώτημα |
| details.samples | int | Αριθμός εγγραφών που βρέθηκαν στη βάση δεδομένων μας και ταιριάζουν με το αίτημά σου |
| details.country | string | Η χώρα που βρήκαμε |
| details.email_sanitized | int | Το όνομα μετά την εφαρμογή του κανονικοποιητή μας |
| details.duration | string | Χρόνος που χρειάστηκε ο διακομιστής για να επεξεργαστεί το αίτημα |
| result_found | bool | Αληθές αν μπορέσαμε να προσδιορίσουμε το φύλο για το συγκεκριμένο όνομα |
| string | Η διεύθυνση email που χρησιμοποιήσαμε για τον προσδιορισμό του φύλου | |
| 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.