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_9fK2mQ7xLp4Rt8Vw1Zc6Nb3Hy5Js0Ad2Una 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:
{
"error": {
"code": "INVALID_API_KEY",
"message": "Missing, invalid or revoked API key.",
"request_id": "req_Qm8vT2kLx9Pw4Rz7Nc1B"
}
}Crear una clave
- En la app, abre API Keys y haz clic en Nueva clave.
- Ponle un nombre (por ejemplo, el servicio que la usará) y elige el entorno: Live (
dcs_live_…) o Test (dcs_test_…). - 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/meyGET /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/executionssolo lista las ejecuciones de su propio workspace. - Las claves solo funcionan en la API pública (
/v1/…). Los endpoints de la app las rechazan con403 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
- Crea una clave nueva.
- Despliega tu aplicación con la clave nueva.
- 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.
Visión general de la API
URL base, versionado, convenciones de solicitudes y respuestas, headers e IDs de la API pública de Dcision.
Ejecutar una decisión
POST /v1/decisions/{slug} — ruta, query, encabezados, cuerpo de la solicitud, cada campo de la respuesta y los errores, con ejemplos en cURL, JavaScript y Python.