Autenticación

La API de Saiku Cloud utiliza autenticación con token Bearer. Toda petición a https://api.saiku.bi/me/* lleva una API key que identifica su tenant.

URL base

https://api.saiku.bi

Abra la página de API keys desde la barra lateral del dashboard.
Haga clic en Crear clave.
Asigne una etiqueta a la clave (por ejemplo, production-agent, staging-bot).
Copie el secreto inmediatamente — solo lo mostramos una vez. Después de este punto, el dashboard solo muestra el ID de la clave
- la etiqueta.

Envíe la clave en el encabezado Authorization:

curl https://api.saiku.bi/me/tenant \
  -H "Authorization: Bearer sk_live_abc123…"

Respuesta correcta:

{
  "tenantId": "81e301f2-…",
  "tenantSlug": "acme",
  "tier": "team",
  "connectionName": "production-warehouse"
}

Los límites de velocidad son por tenant, no por clave. Los límites escalan con su plan:

Cuando alcanza un límite, devolvemos 429 Too Many Requests con un encabezado Retry-After que indica cuándo reintentar.

Toda respuesta de error es JSON:

{
  "error": "payment_required",
  "message": "This feature requires an active subscription or trial. Visit /billing to start your 14-day trial."
}

Códigos de error comunes:

Estado	Código	Significado
`401`	`unauthorized`	API key ausente o inválida
`402`	`payment_required`	El tenant no tiene una suscripción activa
`403`	`forbidden`	API key válida pero sin permiso para este recurso
`404`	`not_found`	El recurso no existe (o no es visible para su tenant)
`429`	`rate_limited`	Límite por minuto o por hora superado

En la página de API keys, haga clic en Crear clave para generar una nueva. Asígnele la misma etiqueta que la clave que está rotando.
Actualice su agente / integración para usar la nueva clave.
Una vez confirmado que la nueva clave funciona en producción, vuelva a la página de API keys y revoque la antigua.

No hay tiempo de inactividad — ambas claves son válidas simultáneamente hasta que revoque la antigua.

Use la API de Facturación para gestionar su suscripción programáticamente.
Lea sobre aislamiento de tenant para entender qué puede y qué no puede alcanzar una API key.