⚡ 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

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
`full_name`	string	Oui	Nom faisant l’objet de la demande
`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 Request Examples

arrow_forward Requête par nom complet uniquement

play_arrow Try Live On Codepen.io

{
    "full_name": "Theresa Miller"
}

arrow_forward Requête par nom complet et code de pays

play_arrow Try Live On Codepen.io

{
    "full_name": "Theresa Miller",
    "country": "US"
}

arrow_forward Requête par nom complet et langue du navigateur

play_arrow Try Live On Codepen.io

{
    "full_name": "Thomas Johnson",
    "locale": "en_US"
}

arrow_forward Requête par nom complet et utilisation d'une adresse IP pour la localisation

play_arrow Try Live On Codepen.io

{
    "full_name": "Markus Stefan NonExistingLastName",
    "ip": "54.201.16.177"
}

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

play_arrow Try Live On Codepen.io

[
    {
        "full_name": "Theresa Miller"
    },
    {
        "full_name": "Thomas Johnson",
        "country": "US"
    }
]

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

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.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