⚡ API unifiée v2.0 AVANCÉ

DOCUMENTATION DE L’API

Découvre notre API unifiée haute performance, conçue pour les utilisateurs avancés avec un volume de requêtes élevé. Interroge plusieurs prénoms en une seule requête avec des temps de réponse ultra-rapides.

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:

POST https://gender-api.com/v2/gender

info Crédits requis : 1

http Headers

Content-Type: application/json

Authorization: Bearer <ton jeton d'autorisation>

link

data_object JSON Payload

Domaine	Type	Requis	Description
`email`	string	Oui	Adresse électronique pour la demande de renseignements
`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

code Exemples de requêtes

arrow_forward Requête par adresse e-mail uniquement

play_arrow Essaie en direct sur Codepen.io

{
    "email": "theresa.miller14@gmail.com"
}

arrow_forward Requête par adresse e-mail et code du pays

play_arrow Essaie en direct sur Codepen.io

{
    "email": "thomas.clarks@hotmail.com",
    "country": "US"
}

arrow_forward Requête par adresse e-mail et navigateur local

play_arrow Essaie en direct sur Codepen.io

{
    "email": "Thomas.j32@live.com",
    "locale": "en_US"
}

arrow_forward Requête par adresse e-mail et utilisation d'une adresse IP pour la localisation

play_arrow Essaie en direct sur Codepen.io

{
    "email": "thomasfromnewyork@gmail.com",
    "ip": "54.201.16.177"
}

arrow_forward Requête de plusieurs noms dans une seule requête

play_arrow Essaie en direct sur Codepen.io

[
    {
        "email": "thomas.clarks@hotmail.com",
        "country": "US"
    },
    {
        "email": "theresa.miller14@gmail.com"
    }
]

check_circle 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"
}

list Champs de la réponse

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
`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 ta demande d’identification de sexe sont précis à 100 %.
`gender`	string	Valeurs possibles : homme, femme, sexe inconnu