Publicar
Créditos requeridos: 2
URL |
https://gender-api.io/v2/country-of-origin
|
Headers |
Content-Type: application/json
|
JSON Payload |
Campo |
Escriba |
Requerido |
Descripción |
first_name |
string |
Si |
Nombre a consultar |
full_name |
string |
No |
Nombre completo para la consulta. Se puede proporcionar en lugar del campo first_name |
email |
string |
No |
Dirección de correo electrónico para consultar. Se puede proporcionar en lugar del campo nombre |
id |
string |
No |
Máximo 50 caracteres. Puede configurar esta identificación a cualquier valor alfanumérico que desee.
Como ejemplo, puede establecer el id a su id interno del conjunto de datos en su base de datos. En un asíncrono
ambiente esto puede ayudar a conectar mejor la respuesta a una solicitud anterior |
|
Ejemplos
Consulta por el primer nombre
{"first_name":"Johann"}
Consulta por nombre completo
{"full_name":"Theresa Miller"}
Consulta por correo electrónico
{"full_name":"sophia5342@gmail.com"}
Respuesta
{
"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
}
]
}
}
Campo |
Escriba |
Descripción |
input |
object |
La carga útil enviada |
details.credits_used |
int |
La cantidad de créditos utilizados para esta consulta |
details.samples |
int |
Número de registros encontrados en nuestra base de datos que coinciden con su solicitud |
details.country |
string |
El país que encontramos |
details.first_name_sanitized |
string |
El nombre después de que le aplicamos nuestro normalizador |
details.duration |
string |
El tiempo que el servidor necesitaba para procesar la solicitud |
result_found |
bool |
Es cierto que si pudiéramos consultar el género del primer nombre |
country_of_origin_map_url |
string |
URL a un mapa interactivo sobre este nombre |
first_name |
string |
El primer nombre que usamos para la genderización |
probability |
float |
Este valor (entre 0 y 1) determina la fiabilidad de nuestra base de datos. Un valor de 1 significa que los resultados de su solicitud de género son 100% exactos |
gender |
string |
Valores posibles: masculino, femenino, desconocido |
country_of_origin |
object |
Los 25 principales países de origen. Consulta "Complete List Of Possible Countries" para una lista de países soportados. Cada registro contiene los campos country_name, country, probability, continental_region y statistical_region |
language_of_origin |
string |
El idioma de origen de este nombre |
meaning |
string |
Una breve descripción del significado de este nombre |
ethnicity |
object |
El campo de etnia proporciona detalles sobre el principal grupo étnico asociado con el nombre, así como la distribución del nombre entre varios grupos étnicos |
ethnicity.id |
string |
El campo id contiene un identificador para el grupo étnico principal determinado. Consulta "Lista completa de posibles grupos étnicos" para una lista completa de posibles grupos étnicos |
ethnicity.name |
string |
El campo de nombre contiene el nombre del principal grupo étnico determinado. Consulta "Lista Completa De Posibles Grupos Étnicos" para una lista completa de posibles grupos étnicos |
ethnicity.distribution |
array |
El campo Distribution contiene información sobre la proporción del nombre dentro de diferentes grupos étnicos. Cada entrada del array contiene los campos id (string), name (string) y percentage (float). Consulta "Lista Completa De Posibles Grupos Étnicos" para una lista completa de valores posibles |