Permisos
Una llave tiene uno de dos accesos. No hay perfilamiento por módulo: la decisión fue mantenerlo simple.
| Acceso | Valor en POST /api-keys | Qué permite |
|---|---|---|
| Escritura y administración | "access": "full" | Todo: leer, crear, editar, sellar, y administrar llaves, usuarios y ajustes. |
| Sólo lectura | "access": "read_only" | Leer todo el sistema. Ninguna escritura, ni siquiera crear una tarea. |
curl -X POST https://www.datrus.cl/api/v1/api-keys \
-H "Authorization: Bearer dtr_live_…" \
-H "Content-Type: application/json" \
-H "Idempotency-Key: 6f1c…" \
-d '{ "name": "Tablero de dirección", "access": "read_only" }'La respuesta trae el secreto una sola vez y la llave con sus permisos expandidos: ["*"] para acceso total, o la lista recurso:read para sólo lectura. Esa lista es lo que verás en GET /me.
Cuando no alcanza
Una operación que exige un permiso que la llave no tiene responde 403 forbidden con el permiso faltante en detail. No se filtra nada por rutas: la referencia declara en cada operación qué permiso pide.