Post
Solicitações necessárias: 1
URL |
https://gender-api.com/v2/gender
|
Headers |
Content-Type: application/json
|
JSON Payload |
Campo |
Tipo |
Publicação |
Descrição |
full_name |
string |
Sim |
Nome a ser consultado |
country |
string |
Não |
Código do país em conformidade com o ISO 3166 ALPHA-2 link |
locale |
string |
Não |
Localidade do navegador |
ip |
string |
Não |
Endereço IPv4 ou IPv6 válido |
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 somente por nome completo
{"full_name":"Theresa Miller"}
Consulta por nome completo e código do país
{"full_name":"Theresa Miller","country":"US"}
Consulta por nome completo e localidade do navegador
{"full_name":"Thomas Johnson","locale":"en_US"}
Consulta por nome completo e usa um endereço IP para localização
{"full_name":"Markus Stefan NonExistingLastName","ip":"54.201.16.177"}
Consulte vários nomes em uma única solicitação
[{"full_name":"Theresa Miller"},{"full_name":"Thomas Johnson","country":"US"}]
Resposta
{
"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"
}
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.full_name_sanitized |
int |
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 |
full_name |
string |
O nome completo que usamos para a determinação do gênero |
probability |
float |
Esse valor (entre 0 e 1) determina a confiabilidade do nosso banco de dados. Um valor de 1 significa que os resultados de sua solicitação de gênero são 100% precisos. |
gender |
string |
Possíveis valores: masculino, feminino, desconhecido |