Autenticación de GenderAPI | Clave API y Bearer Token

Resumen de autenticación

Elige cómo enviar tu clave API

Todas las solicitudes autenticadas requieren una clave válida de GenderAPI. El header Authorization es la opción recomendada porque mantiene las credenciales separadas de los datos de la solicitud.

Token Bearer

Envía la clave en el header Authorization.

Cuerpo JSON

Envía la clave como campo POST desde el servidor.

Método recomendado

Header Authorization

Token Bearer

Configura Authorization: Bearer YOUR_API_KEY y envía únicamente los parámetros de entrada en el cuerpo JSON.

AuthorizationBearer YOUR_API_KEY

cURL

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

JavaScript

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

Método alternativo

Clave API en el cuerpo JSON

Cuerpo POST

Incluye la clave como propiedad key junto a los datos de la solicitud. Utiliza este método únicamente desde código de servidor de confianza.

cURL

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

Python

import requests

response = requests.post(
  "https://api.genderapi.io/api",
  json={
    "name": "Alice",
    "key": "YOUR_API_KEY"
  }
)
print(response.json())

Protección de credenciales

Protege tu clave API

Guarda las claves en variables de entorno del servidor o en un gestor de secretos.
No publiques una clave en el control de versiones ni la expongas en JavaScript del navegador.
Elimina las credenciales de los registros de la aplicación, proxy y analítica.
Utiliza HTTPS en todas las solicitudes y reemplaza cualquier clave que pueda haberse filtrado.

Comparación rápida

¿Qué método deberías utilizar?

Método	Uso recomendado	Ubicación de la credencial
Token BearerRecomendado	La mayoría de integraciones de servidor	Header `Authorization`
Cuerpo JSON	Integraciones POST existentes	Propiedad `key`

Tipo de contenido POST: configura Content-Type: application/json al enviar un cuerpo JSON.

Siguiente guía

Envía una solicitud con un nombre

Género a partir del nombreParámetros y respuesta de una solicitud individual →Bibliotecas clienteVolver a los SDK oficiales →