⚡ API Unificada v2.0 AVANÇADO

DOCUMENTAÇÃO DA API

Experimenta nossa API unificada de alto desempenho, criada para usuários avançados com grande volume de requisições. Consulta vários nomes em uma única requisição com tempos de resposta ultrarrápidos.

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 https://gender-api.com/v2/gender

info Solicitações necessárias: 1

http Headers

Content-Type: application/json

Authorization: Bearer <o seu token de autorização>

link

data_object 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

code Exemplos de requisições

arrow_forward Consulta somente por nome completo

play_arrow Testar ao vivo no Codepen.io

{
    "full_name": "Theresa Miller"
}

arrow_forward Consulta por nome completo e código do país

play_arrow Testar ao vivo no Codepen.io

{
    "full_name": "Theresa Miller",
    "country": "US"
}

arrow_forward Consulta por nome completo e localidade do navegador

play_arrow Testar ao vivo no Codepen.io

{
    "full_name": "Thomas Johnson",
    "locale": "en_US"
}

arrow_forward Consulta por nome completo e usa um endereço IP para localização

play_arrow Testar ao vivo no Codepen.io

{
    "full_name": "Markus Stefan NonExistingLastName",
    "ip": "54.201.16.177"
}

arrow_forward Consulte vários nomes em uma única solicitação

play_arrow Testar ao vivo no Codepen.io

[
    {
        "full_name": "Theresa Miller"
    },
    {
        "full_name": "Thomas Johnson",
        "country": "US"
    }
]

check_circle 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"
}

list Campos da resposta

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