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.
Ver API v1.0

OpenAPI

Veja nossa documentação da API no Swagger

Postman

Importe nossa definição de API para o Postman
Consultar por primeiro nome
Consulta por Nome Completo
Consulta por endereço de e-mail
Obter País de Origem
Obter Estatísticas
Códigos de erro

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>
link
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
play_arrow Teste ao vivo com codepen.io 
{"full_name":"Theresa Miller"}
Consulta por nome completo e código do país
play_arrow Teste ao vivo com codepen.io 
{"full_name":"Theresa Miller","country":"US"}
Consulta por nome completo e localidade do navegador
play_arrow Teste ao vivo com codepen.io 
{"full_name":"Thomas Johnson","locale":"en_US"}
Consulta por nome completo e usa um endereço IP para localização
play_arrow Teste ao vivo com codepen.io 
{"full_name":"Markus Stefan NonExistingLastName","ip":"54.201.16.177"}
Consulte vários nomes em uma única solicitação
play_arrow Teste ao vivo com codepen.io 
[{"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.
Bate-papo