Docs API API unifiée v2.0
API v1.0
Nous proposons également une autre version de l'API avec des points de terminaison plus faciles à intégrer. Si tu es un débutant dans la mise en œuvre des API, tu peux passer à notre point de terminaison v1.0.
Requête par adresse e-mail
Tu peux également faire une demande relative au sexe d’une personne sur la base d’une adresse électronique contenant un prénom:
Poster
Crédits requis : 1
URL |
https://gender-api.com/v2/gender
|
||||||||||||||||||||||||
Headers |
Content-Type: application/json
Authorization: Bearer <ton jeton d'autorisation>
|
||||||||||||||||||||||||
JSON Payload |
|
Exemple
Requête par adresse e-mail uniquement
{"email":"theresa.miller14@gmail.com"}
Requête par adresse e-mail et code du pays
{"email":"thomas.clarks@hotmail.com","country":"US"}
Requête par adresse e-mail et navigateur local
{"email":"Thomas.j32@live.com","locale":"en_US"}
Requête par adresse e-mail et utilisation d'une adresse IP pour la localisation
{"email":"thomasfromnewyork@gmail.com","ip":"54.201.16.177"}
Requête de plusieurs noms dans une seule requête
[{"email":"thomas.clarks@hotmail.com","country":"US"},{"email":"theresa.miller14@gmail.com"}]
Réponse
{
"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"
}
Domaine | Type | Description |
---|---|---|
input | object | La charge utile soumise |
details.credits_used | int | Quantité de crédits utilisés pour cette demande |
details.samples | int | Nombre d’enregistrements trouvés dans notre base de données qui correspondent à ta demande |
details.country | string | Le pays que nous avons trouvé |
details.email_sanitized | int | Le nom après utilisation de notre normalisateur |
details.duration | string | Temps nécessaire au serveur pour traiter la demande |
result_found | bool | Vrai si on pouvait interroger un genre pour le prénom |
string | L'adresse e-mail que nous avons utilisée pour la sexospécificité | |
probability | float | Cette valeur indique la fiabilité de notre base de données. Une valeur de 1 signifie que les résultats concernant ta demande d’identification de sexe sont précis à 100 %. |
gender | string | Valeurs possibles : homme, femme, sexe inconnu |
Ce produit comprend des données GeoLite2 créées par MaxMind, disponibles auprès de http://www.maxmind.com.