Autenticación

Todas las requests a la API requieren un header Authorization con un Bearer token (API key). Cada cuenta puede generar múltiples keys con nombre, ver el último uso y revocarlas en cualquier momento.

Formato del header

Authorization: Bearer cbct_live_a3f9b1c2d4e5f6g7h8i9j0k1l2m3n4o5

Cómo crear una API key

1. Crea una cuenta en cbcthub.com/signup (Free disponible).
2. En el dashboard, abre Ajustes → API.
3. Pon un nombre descriptivo (ej: “Sistema clínico interno”) y haz clic en Crear key.
4. La key se muestra UNA SOLA VEZ. Cópiala y guárdala en el secret manager de tu sistema (variables de entorno, AWS Secrets Manager, Vault, Doppler).

Permisos por scope

Cada key tiene scopes que indican qué puede hacer. Hoy las keys se crean con ambos scopes activos:

• exams:read — listar y leer exámenes
• exams:write — crear, confirmar y eliminar exámenes

Revocar keys

Desde Ajustes → API podés revocar cualquier key. La revocación es inmediata: las llamadas posteriores devuelven 401. Las keys revocadas quedan en el listado por audit, pero no se reactivan.

Qué pasa si la key es inválida

Si la key es inválida, ausente, malformada o revocada, recibís 401 unauthorized:

{
  "error": {
    "code": "unauthorized",
    "message": "Invalid or revoked API key."
  }
}