Autenticación (Authentication)

Todas las solicitudes API a GenderAPI requieren autenticación. Puedes autenticar tus solicitudes de dos maneras:

1. API Key en el cuerpo del POST como parámetro key
2. API Key en el header Authorization usando un Bearer token

1. API Key en el cuerpo del POST

La forma más sencilla de autenticarte es incluyendo tu API Key como un campo llamado key en el cuerpo JSON de tu solicitud POST.

Por ejemplo, para determinar el género del nombre "Alice":

Ejemplo con cURL

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

Ejemplo con 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));

Ejemplo con 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 en el header Authorization (Bearer Token)

Para mayor seguridad y solicitudes más limpias, puedes enviar tu API Key en el header Authorization usando el esquema Bearer. Con este método, no incluyes la API Key en el cuerpo JSON.

En su lugar, sólo tus parámetros de entrada (como name) se envían en el cuerpo del POST.

Por ejemplo, para determinar el género del nombre "Alice":

Ejemplo con cURL

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

Ejemplo con 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));

Ejemplo con 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())

Elegir entre los dos métodos

Ambos métodos de autenticación son compatibles en todos los endpoints de la API. Sin embargo, usar el header Authorization es más seguro porque mantiene tu API Key fuera del cuerpo de la solicitud y evita que se registre accidentalmente.

Sin importar el método que utilices, siempre establece el header Content-Type en application/json cuando envíes solicitudes POST.