Documentação da API Unified API v2.0
API v1.0
Nós também oferecemos outra versão de API com pontos de extremidade que são mais fáceis de integrar. Se você é um iniciante na implementação de APIs, pode mudar para o nosso ponto de extremidade v1.0.
Consulta por nome completo - DIVIDIR NOME E SOBRENOME
Se você usar um campo combinado para nome e sobrenome em sua página, use esta API para extrair as partes:
Post
Solicitações necessárias: 1
URL |
https://gender-api.com/v2/gender
|
||||||||||||||||||||||||
Headers |
Content-Type: application/json
Authorization: Bearer <o seu token de autorização>
|
||||||||||||||||||||||||
JSON Payload |
|
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 |
Este produto inclui dados GeoLite2 criados pela MaxMind, disponíveis em http://www.maxmind.com.