Skip to content

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_fc4639e7f81aba67b3900f89666551ba

Crear un token

  1. Abrí el dashboard
  2. Scrolleá hasta API Tokens → hacé clic en Nuevo token
  3. Seleccioná la base de datos, asigná un nombre y elegí los permisos
  4. Copiá el token de inmediato — se muestra una sola vez

Permisos del token

Cada token tiene permisos independientes por base de datos:

PermisoQué permite
SELECTLeer filas de cualquier tabla
INSERTAgregar nuevas filas
UPDATEModificar filas existentes
DELETEEliminar 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_" }