Autenticação

A API do Saiku Cloud usa autenticação por Bearer token. Toda requisição para https://api.saiku.bi/me/* carrega uma API key que identifica o seu tenant.

Dica

Conectando um cliente de chat com LLM (Claude Desktop, claude.ai, Cursor) ao servidor MCP? Esses clientes não precisam de uma API key — eles se autenticam pelo conector OAuth 2.1 (self-service, Team em diante). Veja Conectar um agente. As API keys são para acesso programático e REST.

URL base

https://api.saiku.bi

Gerar uma API key

Dica

Cada API key é vinculada ao seu tenant do lado do servidor. Não compartilhe chaves fora da sua equipe — rotacione imediatamente se uma chave for exposta.

1. Abra a página API keys na barra lateral do dashboard.
2. Clique em Criar chave.
3. Dê um rótulo à chave (ex.: production-agent, staging-bot).
4. Copie o segredo imediatamente — só o mostramos uma vez. A partir desse ponto o dashboard exibe apenas o ID + o rótulo da chave.

Fazer uma requisição

Envie a chave no header Authorization:

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

Resposta de sucesso:

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

Limites de taxa

Os limites de taxa são por tenant, não por chave. Os limites escalam com o seu plano:

Tier	Por minuto	Por hora
Starter	60	1 000
Team	300	10 000
Business	1 000	50 000
Enterprise	Personalizado	Personalizado

Ao atingir o limite, retornamos 429 Too Many Requests com um header Retry-After indicando quando tentar novamente.

Formato da resposta de erro

Toda resposta de erro é JSON:

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

Códigos de erro comuns:

Status	Code	Significado
401	unauthorized	API key ausente ou inválida
402	payment_required	O tenant não tem assinatura ativa
403	forbidden	API key válida mas sem permissão para este recurso
404	not_found	Recurso inexistente (ou não visível para o seu tenant)
429	rate_limited	Limite por minuto ou por hora excedido

Rotacionar uma chave

1. Na página API keys, clique em Criar chave para gerar uma nova. Use o mesmo rótulo da chave que você está rotacionando.
2. Atualize seu agente / integração para usar a nova chave.
3. Depois de confirmar que a nova chave funciona em produção, volte à página API keys e revogue a antiga.

Não há indisponibilidade — ambas as chaves ficam válidas simultaneamente até que você revogue a antiga.

Próximos passos

• Use a API de Billing para gerenciar sua assinatura programaticamente.
• Leia sobre isolamento de tenant para entender o que uma API key pode e não pode alcançar.