API Docs Unified API v2.0

API v1.0

We also offer another API version with endpoints that are easier to integrate. If you're a beginner in implementing API's you can switch to our v1.0 endpoint.

Requête par adresse e-mail

Vous pouvez é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 <votre jeton d'autorisation>
link
JSON Payload
Domaine Type Requis Description
email string Oui Email address to query
country string Non Code pays ISO 3166 ALPHA-2
link
locale string Non Navigateur local
ip string Non Adresse IPv4 ou IPv6 valide
id string Non Max 50 chars. Vous pouvez régler cet identifiant sur la valeur alphanumérique de votre choix. Par exemple, vous pouvez définir l'identifiant comme étant votre identifiant interne de l'ensemble de données de votre base de données. Dans un environnement asynchrone cela peut vous aider à mieux relier la réponse à une demande précédente

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": "Sandra"
    },
    "details": {
        "credits_used": 1,
        "samples": 464,
        "country": null,
        "email_sanitized": "sandra",
        "duration": "436ms"
    },
    "result_found": true,
    "email": "Sandra",
    "probability": 0.85,
    "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 à votre 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
email 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 votre 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.
Chat

Cookies

We use cookies (including third-party cookies) to collect information about visitors' use of our website. These cookies help us to provide you with the best possible online experience and to constantly improve our websites. Information collected via cookies may also be processed outside the European Union, for example, in the USA. By clicking the "Accept All" button, you agree to the use of cookies. To withdraw your consent at any time, change your settings or for more information about the use of cookies, click here or "Cookie Settings" at the end of the page.