⚡ API unifiée v2.0
AVANCÉ
API DOCUMENTATION
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 nom complet - SÉPARER LE PRÉNOM DU NOM
Si tu utilises un champ combiné pour le prénom et le nom sur votre page, utilise cette API pour extraire les différentes parties:
POST https://gender-api.com/v2/gender
Crédits requis : 1
| Headers |
Content-Type: application/json
Authorization: Bearer <ton jeton d'autorisation>
|
||||||||||||||||||||||||
| JSON Payload |
|
Request Examples
Requête par nom complet uniquement
Try Live On Codepen.io
{
"full_name": "Theresa Miller"
}
Requête par nom complet et code de pays
Try Live On Codepen.io
{
"full_name": "Theresa Miller",
"country": "US"
}
Requête par nom complet et langue du navigateur
Try Live On Codepen.io
{
"full_name": "Thomas Johnson",
"locale": "en_US"
}
Requête par nom complet et utilisation d'une adresse IP pour la localisation
Try Live On Codepen.io
{
"full_name": "Markus Stefan NonExistingLastName",
"ip": "54.201.16.177"
}
Requête de plusieurs noms dans une seule requête
Try Live On Codepen.io
[
{
"full_name": "Theresa Miller"
},
{
"full_name": "Thomas Johnson",
"country": "US"
}
]
Réponse
{
"input": {
"full_name": "Theresa Miller"
},
"details": {
"credits_used": 1,
"duration": "33ms",
"samples": 8961,
"country": null,
"first_name_sanitized": "theresa"
},
"result_found": true,
"last_name": "Miller",
"first_name": "Theresa",
"probability": 0.98,
"gender": "female"
}
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.full_name_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 |
full_name |
string | Le nom complet que nous avons utilisé 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 |