Autenticación
Toda solicitud a la Query API de Celdrax debe incluir un Bearer token en el header Authorization.
Formato del token
Los tokens de Celdrax siempre comienzan con cxk_:
Authorization: Bearer cxk_fc4639e7f81aba67b3900f89666551baCrear un token
- Abrí el dashboard
- Scrolleá hasta API Tokens → hacé clic en Nuevo token
- Seleccioná la base de datos, asigná un nombre y elegí los permisos
- Copiá el token de inmediato — se muestra una sola vez
Permisos del token
Cada token tiene permisos independientes por base de datos:
| Permiso | Qué permite |
|---|---|
SELECT | Leer filas de cualquier tabla |
INSERT | Agregar nuevas filas |
UPDATE | Modificar filas existentes |
DELETE | Eliminar filas |
Principio de mínimo privilegio
Creá tokens separados para distintos casos de uso. Un token de solo lectura para el frontend, un token con acceso completo para el backend.
Revocar un token
Hacé clic en el ícono de papelera junto al token en el dashboard. Se revoca de inmediato — cualquier solicitud en curso que lo use recibirá un 401.
Respuestas de error
json
// Header faltante
{ "error": "Missing Authorization header. Use: Bearer cxk_..." }
// Token inválido o revocado
{ "error": "Invalid or revoked token" }
// Formato de token incorrecto
{ "error": "Invalid token format. Celdrax tokens start with cxk_" }