Docs API API unifiée v2.0
API v1.0
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.
Recherche par nom
Constitue la manière la plus simple de faire une demande d’identification de sexe. Chaque réponse est encodée au format JSON:
Poster
Required Requests: 1
| URL |
https://gender-api.com/v2/gender
|
||||||||||||||||||||||||
| Headers |
Content-Type: application/json
Authorization: Bearer <ton jeton d'autorisation>
|
||||||||||||||||||||||||
| JSON Payload |
|
Exemple
Requête par prénom uniquement
{"first_name":"Sandra"}Requête par prénom et code pays
{"first_name":"Sandra","country":"US"}Requête par le prénom et la langue du navigateur
{"first_name":"Sandra","locale":"en_US"}Requête par le prénom et utilisation d'une adresse IP pour la localisation
{"first_name":"Sandra","ip":"54.201.16.177"}Requête de plusieurs noms dans une seule requête
[{"first_name":"Sandra","country":"US"},{"first_name":"Jason","country":"US"}]Réponse
{
"input": {
"first_name": "Sandra"
},
"details": {
"credits_used": 1,
"samples": 464,
"country": null,
"first_name_sanitized": "sandra",
"duration": "436ms"
},
"result_found": true,
"first_name": "Sandra",
"probability": 0.85,
"gender": "female"
}| Domaine | Type | Description |
|---|---|---|
| input | object | La charge utile soumise |
| details.credits_used | int | The amount of requests used for this query |
| 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.first_name_sanitized | string | 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 |
| first_name | string | Le premier nom 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 |
Ce produit comprend des données GeoLite2 créées par MaxMind, disponibles auprès de http://www.maxmind.com.
