Autenticação (Authentication)

Todas as requisições à API do GenderAPI exigem autenticação. Você pode autenticar suas requisições de duas maneiras:

1. API Key no corpo do POST como parâmetro key
2. API Key no header Authorization utilizando um Bearer token

1. API Key no corpo do POST

A forma mais simples de autenticação é incluir sua API Key como um campo chamado key no corpo JSON da sua requisição POST.

Por exemplo, para determinar o gênero do nome “Alice”:

Exemplo com cURL

curl -X POST "https://api.genderapi.io/api" \
     -H "Content-Type: application/json" \
     -d '{"name": "Alice", "key": "YOUR_API_KEY"}'

Exemplo com JavaScript fetch

fetch("https://api.genderapi.io/api", {
  method: "POST",
  headers: {
    "Content-Type": "application/json"
  },
  body: JSON.stringify({
    name: "Alice",
    key: "YOUR_API_KEY"
  })
})
.then(response => response.json())
.then(data => console.log(data));

Exemplo com Python requests

import requests

url = "https://api.genderapi.io/api"

payload = {
    "name": "Alice",
    "key": "YOUR_API_KEY"
}

headers = {
    "Content-Type": "application/json"
}

response = requests.post(url, headers=headers, json=payload)

print(response.json())

2. API Key no header Authorization (Bearer Token)

Para maior segurança e requisições mais limpas, você pode enviar sua API Key no header Authorization usando o esquema Bearer. Nessa abordagem, você não inclui a API Key no corpo JSON.

Em vez disso, apenas seus parâmetros de entrada (como name) são enviados no corpo do POST.

Por exemplo, para determinar o gênero do nome “Alice”:

Exemplo com cURL

curl -X POST "https://api.genderapi.io/api" \
     -H "Content-Type: application/json" \
     -H "Authorization: Bearer YOUR_API_KEY" \
     -d '{"name": "Alice"}'

Exemplo com JavaScript fetch

fetch("https://api.genderapi.io/api", {
  method: "POST",
  headers: {
    "Content-Type": "application/json",
    "Authorization": "Bearer YOUR_API_KEY"
  },
  body: JSON.stringify({
    name: "Alice"
  })
})
.then(response => response.json())
.then(data => console.log(data));

Exemplo com Python requests

import requests

url = "https://api.genderapi.io/api"

payload = {
    "name": "Alice"
}

headers = {
    "Content-Type": "application/json",
    "Authorization": "Bearer YOUR_API_KEY"
}

response = requests.post(url, headers=headers, json=payload)

print(response.json())

Escolhendo entre os dois métodos

Ambos os métodos de autenticação são suportados em todos os endpoints da API. No entanto, usar o header Authorization é mais seguro, pois mantém sua API Key fora do corpo da requisição e evita que ela seja registrada acidentalmente em logs.

Independentemente do método utilizado, sempre defina o header Content-Type como application/json ao fazer requisições POST.