⚡ API unifiée v2.0 AVANCÉ

Docs API API unifiée v2.0

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.

API v1.0 SIMPLE

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.

API de visualisation v1.0 →

🚀 Outils API

Explore notre API avec des outils standard de l’industrie

Voir la documentation Swagger → Importation vers Postman →

Requête par nom

Requête par nom complet

Requête par adresse e-mail

Obtenir le pays d'origine

Obtenir des statistiques

Codes d’erreur

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

info Crédits requis : 1

link URL

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

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 Exemple

Requête par nom complet uniquement

play_arrow Teste en direct avec codepen.io

{
    "full_name": "Theresa Miller"
}

Requête par nom complet et code de pays

play_arrow Teste en direct avec codepen.io

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

Requête par nom complet et langue du navigateur

play_arrow Teste en direct avec codepen.io

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

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

play_arrow Teste en direct avec codepen.io

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

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

play_arrow Teste en direct avec 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