Autenticación

​

Conceptos

• API Key por organización: cada organización administra su propia clave.
• Header: envía la clave en x-api-key.
• Ámbito: acceso a recursos asociados a tu organización.

​

Ejemplos

curl -X GET "https://api.esolbay.com/api/v1/items/" \
  -H "x-api-key: $ESOLBAY_API_KEY"

const res = await fetch("https://api.esolbay.com/api/v1/items/", {
  headers: { "x-api-key": process.env.ESOLBAY_API_KEY! },
});
if (!res.ok) throw new Error(`HTTP ${res.status}`);
const items = await res.json();

import os, requests
res = requests.get(
  'https://api.esolbay.com/api/v1/items/',
  headers={'x-api-key': os.environ['ESOLBAY_API_KEY']}
)
res.raise_for_status()
items = res.json()

​

Gestión de secretos

• Usa gestores de secretos (Vault, AWS Secrets Manager, Doppler) o variables de entorno.
• No compartas la API Key en clientes públicos.
• Rota la clave periódicamente.

​

Errores comunes

• 401 Unauthorized: header ausente/incorrecto.
• 403 Forbidden: recursos fuera del ámbito de tu organización.