Poster
Crédits requis : 2
| URL |
https://gender-api.com/v2/country-of-origin
|
| Headers |
Content-Type: application/json
|
| JSON Payload |
| Domaine |
Type |
Requis |
Description |
| first_name |
string |
Oui |
Prénom à faire la requête |
| full_name |
string |
Non |
Nom complet à faire la requête. Peut être fourni à la place du champ prénom |
| email |
string |
Non |
Adresse e-mail à faire la requête. Peut être fournie à la place du champ prénom |
| 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
Recherche par nom
{"first_name":"Johann"}
Requête par nom complet
{"full_name":"Theresa Miller"}
Requête par adresse e-mail
{"full_name":"sophia5342@gmail.com"}
Réponse
{
"input": {
"first_name": "Johann",
"id": 12
},
"details": {
"credits_used": 2,
"duration": "414ms",
"samples": 890,
"country": null,
"first_name_sanitized": "johann"
},
"result_found": true,
"country_of_origin": [
{
"country_name": "Germany",
"country": "DE",
"probability": 0.52,
"continental_region": "Europe",
"statistical_region": "Western Europe"
},
{
"country_name": "Austria",
"country": "AT",
"probability": 0.48,
"continental_region": "Europe",
"statistical_region": "Western Europe"
}
],
"first_name": "Johann",
"probability": 0.9,
"gender": "male",
"language_of_origin": "Germanic",
"meaning": "Johann is the German variation of the name John, which means 'God is gracious'. It was frequently used in the Middle Ages across Europe, particularly as a name for religious figures.",
"ethnicity": {
"id": "GERMANIC",
"name": "Germanic (German, Austrian, Swiss)",
"distribution": [
{
"id": "GERMANIC",
"name": "Germanic (German, Austrian, Swiss)",
"percentage": 90
},
{
"id": "DUTCH",
"name": "Dutch",
"percentage": 5
},
{
"id": "FRENCH",
"name": "French",
"percentage": 5
}
]
}
}
| 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.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 |
| country_of_origin_map_url |
string |
URL vers une carte interactive sur ce nom |
| first_name |
string |
Le premier nom que nous avons utilisé pour la sexospécificité |
| probability |
float |
Cette valeur (entre 0 et 1) détermine la fiabilité de notre base de données. Une valeur de 1 signifie que les résultats de votre demande de sexe sont à 100% fiable |
| gender |
string |
Valeurs possibles : homme, femme, sexe inconnu |
| country_of_origin |
object |
Top 25 pays d'origine. Voir "Liste complète des pays possibles" pour une liste des pays supportés. Chaque enregistrement contient les champs country_name, country, probability, continental_region et statistical_region |
| language_of_origin |
string |
La langue d'origine de ce nom |
| meaning |
string |
Une brève description de la signification de ce nom |
| ethnicity |
object |
Le champ d'ethnicité fournit des détails sur le principal groupe ethnique associé au nom, ainsi que sur la répartition du nom parmi divers groupes ethniques |
| ethnicity.id |
string |
Le champ id contient un identifiant pour le groupe ethnique principal déterminé. Voir "Liste complète des groupes ethniques possibles" pour une liste complète des groupes ethniques possibles |
| ethnicity.name |
string |
Le champ nom contient le nom du principal groupe ethnique déterminé. Voir "Complete List Of Possible Ethnic Groups" pour une liste complète des groupes ethniques possibles |
| ethnicity.distribution |
array |
Le champ Distribution contient des informations sur la proportion du nom au sein des différents groupes ethniques. Chaque entrée du tableau contient les champs id (chaîne), name (chaîne) et percentage (flottant). Voir "Liste complète des groupes ethniques possibles" pour une liste complète des valeurs possibles |