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.
API de visualisation v1.0

OpenAPI

Consulter la documentation de notre API en Swagger

Postman

Importes notre définition d'API dans 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:

Poster
Crédits requis : 1
URL
https://gender-api.io/v2/gender
Headers
Content-Type: application/json
Authorization: Bearer <ton jeton d'autorisation>
link
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

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"}]
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"
}
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
Ce produit comprend des données GeoLite2 créées par MaxMind, disponibles auprès de http://www.maxmind.com.
Chat