Post
Solicitações necessárias: 2
| URL |
https://gender-api.com/v2/country-of-origin
|
| Headers |
Content-Type: application/json
|
| JSON Payload |
| Campo |
Tipo |
Publicação |
Descrição |
| first_name |
string |
Sim |
Primeiro nome a pesquisar |
| full_name |
string |
Não |
Nome completo a pesquisar. Pode ser fornecido em vez do campo primeiro_nome |
| email |
string |
Não |
Endereço de e-mail a pesquisar. Pode ser fornecido em vez do campo primeiro_nome |
| id |
string |
Não |
Máximo de 50 caracteres. Você pode definir este ID com qualquer valor alfanumérico que desejar.
Como exemplo, você pode definir o ID como seu ID interno do conjunto de dados em seu banco de dados. Em um ambiente assíncrono, isso pode ajudá-lo a conectar a resposta a uma solicitação anterior |
|
Exemplos
Consulta por primeiro nome
{"first_name":"Johann"}
Consulta por nome completo
{"full_name":"Theresa Miller"}
Consulta por endereço de e-mail
{"full_name":"sophia5342@gmail.com"}
Resposta
{
"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 |
Tipo |
Descrição |
| input |
object |
Carga útil submetida |
| details.credits_used |
int |
A quantidade de solicitações usadas para esta consulta |
| details.samples |
int |
Número de registros encontrados em nosso banco de dados correspondentes à sua solicitação |
| details.country |
string |
O país que encontramos |
| details.first_name_sanitized |
string |
O nome depois de aplicarmos nosso normalizador |
| details.duration |
string |
Tempo que o servidor precisou para processar a solicitação |
| result_found |
bool |
Verdadeiro se pudermos consultar um gênero para o nome dado |
| country_of_origin_map_url |
string |
URL para um mapa interativo sobre este nome |
| first_name |
string |
O primeiro nome que usamos para determinação de gênero |
| probability |
float |
Este valor (entre 0 e 1) determina a confiabilidade do nosso banco de dados. Um valor de 1 significa que os resultados da sua solicitação de gênero são 100% precisos |
| gender |
string |
Possíveis valores: masculino, feminino, desconhecido |
| country_of_origin |
object |
Principais 25 países de origem. Veja "Lista Completa dos Possíveis Países" para uma lista dos países suportados. Cada registro contém os campos country_name, country, probability, continental_region e statistical_region |
| language_of_origin |
string |
O idioma de origem desse nome |
| meaning |
string |
Uma breve descrição do significado desse nome |
| ethnicity |
object |
O campo de etnia fornece detalhes sobre o principal grupo étnico associado ao nome, assim como a distribuição do nome entre vários grupos étnicos |
| ethnicity.id |
string |
O campo id contém um identificador para o principal grupo étnico determinado. Veja "Lista Completa de Possíveis Grupos Étnicos" para uma lista completa de possíveis grupos étnicos |
| ethnicity.name |
string |
O campo de nome contém o nome do grupo étnico principal determinado. Veja "Lista Completa De Possíveis Grupos Étnicos" para uma lista completa de possíveis grupos étnicos |
| ethnicity.distribution |
array |
O campo Distribution contém informações sobre a proporção do nome dentro de diferentes grupos étnicos. Cada entrada de array contém os campos id (string), name (string) e percentage (float). Veja "Lista Completa De Possíveis Grupos Étnicos" para uma lista completa de valores possíveis |