Authentification

L’API Saiku Cloud utilise l’authentification par jeton Bearer. Chaque requête vers https://api.saiku.bi/me/* transporte une clé API qui identifie votre tenant.

Astuce

Vous connectez un client de chat LLM (Claude Desktop, claude.ai, Cursor) au serveur MCP ? Ces clients n’ont pas besoin de clé API — ils s’authentifient via le connecteur OAuth 2.1 (en libre-service, Team et au-delà). Voir Connexion d’un agent. Les clés API sont destinées à l’accès programmatique et REST.

URL de base

https://api.saiku.bi

Création d’une clé API

Astuce

Chaque clé API est liée à votre tenant côté serveur. Ne partagez pas les clés en dehors de votre équipe — effectuez une rotation immédiatement si une clé est exposée.

1. Ouvrez la page des clés API depuis la barre latérale du dashboard.
2. Cliquez sur Créer une clé.
3. Donnez à la clé un libellé (par exemple production-agent, staging-bot).
4. Copiez le secret immédiatement — nous ne l’affichons qu’une seule fois. Passé ce point, le dashboard n’affiche plus que l’ID + le libellé de la clé.

Effectuer une requête

Envoyez la clé dans l’en-tête Authorization :

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

Réponse réussie :

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

Limites de débit

Les limites de débit s’appliquent par tenant, et non par clé. Elles évoluent en fonction de votre plan :

Niveau	Par minute	Par heure
Starter	60	1 000
Team	300	10 000
Business	1 000	50 000
Enterprise	Personnalisé	Personnalisé

Lorsque vous atteignez une limite, nous renvoyons 429 Too Many Requests avec un en-tête Retry-After indiquant quand réessayer.

Forme des réponses d’erreur

Chaque réponse d’erreur est au format JSON :

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

Codes d’erreur courants :

Statut	Code	Signification
401	unauthorized	Clé API manquante ou invalide
402	payment_required	Le tenant n’a pas d’abonnement actif
403	forbidden	Clé API valide mais sans permission pour cette ressource
404	not_found	La ressource n’existe pas (ou n’est pas visible pour votre tenant)
429	rate_limited	Limite par minute ou par heure dépassée

Rotation d’une clé

1. Sur la page des clés API, cliquez sur Créer une clé pour en créer une nouvelle. Donnez-lui le même libellé que la clé que vous remplacez.
2. Mettez à jour votre agent / intégration pour utiliser la nouvelle clé.
3. Une fois que vous avez confirmé que la nouvelle clé fonctionne en production, retournez à la page des clés API et révoquez l’ancienne.

Il n’y a pas d’interruption — les deux clés sont valides simultanément jusqu’à ce que vous révoquiez l’ancienne.

Et ensuite

• Utilisez l’API de facturation pour gérer votre abonnement de manière programmatique.
• Lisez l’isolation des tenants pour comprendre ce qu’une clé API peut et ne peut pas atteindre.