⚡ 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 primeiro nome

Esta é a maneira mais fácil de consultar o gênero de um nome. Cada resposta é codificada em JSON:

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
`first_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 por somente o primeiro nome

play_arrow Testar ao vivo no Codepen.io

{
    "first_name": "Sandra"
}

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

play_arrow Testar ao vivo no Codepen.io

{
    "first_name": "Sandra",
    "country": "US"
}

arrow_forward Consulta por primeiro nome e localidade do navegador

play_arrow Testar ao vivo no Codepen.io

{
    "first_name": "Sandra",
    "locale": "en_US"
}

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

play_arrow Testar ao vivo no Codepen.io

{
    "first_name": "Sandra",
    "ip": "54.201.16.177"
}

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

play_arrow Testar ao vivo no Codepen.io

[
    {
        "first_name": "Sandra",
        "country": "US"
    },
    {
        "first_name": "Jason",
        "country": "US"
    }
]

check_circle Resposta

{
    "input": {
        "first_name": "Sandra"
    },
    "details": {
        "credits_used": 1,
        "samples": 464,
        "country": null,
        "first_name_sanitized": "sandra",
        "duration": "436ms"
    },
    "result_found": true,
    "first_name": "Sandra",
    "probability": 0.85,
    "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.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
`first_name`	string	O primeiro nome que usamos para determinação de 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