Autenticación

Autentícate con claves de API Bearer (dcs_live_ y dcs_test_) — créalas, guárdalas, rótalas y revócalas — y conoce dónde funcionan.

Cada llamada a la API pública necesita una clave de API en el header Authorization:

Authorization: Bearer dcs_live_9fK2mQ7xLp4Rt8Vw1Zc6Nb3Hy5Js0Ad2

Una clave es dcs_live_ o dcs_test_ seguido de 32 letras y dígitos. Un header ausente, un esquema distinto de Bearer, o una clave mal formada, desconocida o revocada fallan con:

401 Unauthorized
{
  "error": {
    "code": "INVALID_API_KEY",
    "message": "Missing, invalid or revoked API key.",
    "request_id": "req_Qm8vT2kLx9Pw4Rz7Nc1B"
  }
}

Crear una clave

  1. En la app, abre API Keys y haz clic en Nueva clave.
  2. Ponle un nombre (por ejemplo, el servicio que la usará) y elige el entorno: Live (dcs_live_…) o Test (dcs_test_…).
  3. Haz clic en Crear clave y cópiala. La clave completa se muestra una sola vez.

Guárdala en tu gestor de secretos o como una variable de entorno, como DCISION_API_KEY. Dcision solo guarda un hash SHA-256 de la clave, así que una clave perdida no se puede recuperar — crea una nueva.

La lista de claves muestra el nombre de cada clave, una forma enmascarada (dcs_live_9fK2…0Ad2), su entorno, cuándo se creó y cuándo se usó por última vez (actualizado como máximo una vez por minuto). Los Miembros, Administradores y el Propietario pueden crear, renombrar y revocar claves; los Lectores solo ven la lista — consulta Equipo, roles y cuenta. Un workspace puede tener hasta 50 claves activas.

Claves live y de test

Ambos entornos se comportan igual: llaman a las mismas versiones desplegadas, comparten el rate limit del workspace y se facturan de la misma forma. La diferencia es organizativa — reserva las claves de test para staging, CI y desarrollo local, así puedes revocarlas sin tocar producción — más una marca: las entregas de destinos de las llamadas hechas con una clave de test llevan livemode: false, para que los receptores puedan mantenerlas fuera de producción.

Alcance

  • Una clave pertenece a un workspace y puede llamar a todas las decisiones de ese workspace, y leer sus decisiones, su cuenta y sus ejecuciones con GET /v1/decisions, GET /v1/me y GET /v1/executions. La misma clave autentica el servidor MCP.
  • Una clave de otro workspace no puede llegar a tus decisiones: recibe 404 DECISION_NOT_FOUND, y su /v1/executions solo lista las ejecuciones de su propio workspace.
  • Las claves solo funcionan en la API pública (/v1/…). Los endpoints de la app las rechazan con 403 FORBIDDEN — "API keys can only call the /v1 decision endpoints."

Verificar una clave

GET /v1/me responde 200 con el workspace, el nombre, el entorno y el plan de la clave, o 401 INVALID_API_KEY. Es una comprobación barata para CI y scripts de deploy — no ejecuta ninguna decisión y no se factura:

curl -sf https://api.dcision.io/v1/me -H "Authorization: Bearer $DCISION_API_KEY" > /dev/null \
  && echo "key OK" || echo "key rejected"

Rotar una clave

  1. Crea una clave nueva.
  2. Despliega tu aplicación con la clave nueva.
  3. Revoca la clave anterior cuando su Último uso deje de cambiar.

Revocar una clave

Revocar tiene efecto de inmediato y no se puede deshacer: cada solicitud con la clave falla con 401 INVALID_API_KEY. Las claves revocadas permanecen en la lista, en gris, como referencia.

Mantén las claves seguras

  • Llama a la API desde tu servidor, nunca desde un navegador, una app móvil o un bundle del cliente.
  • Nunca hagas commit de claves en un repositorio; cárgalas desde el entorno.
  • Usa una clave por servicio para poder revocar una sin afectar a las demás.

En esta página