Authentification
L’API Saiku Cloud utilise l’authentification par jeton Bearer. Chaque
requête vers https://api.saiku.bi/me/* porte une clé API qui
identifie votre tenant.
URL de base
https://api.saiku.biÉmettre une clé API
- Ouvrez la page Clés API depuis la barre latérale du dashboard.
- Donnez à la clé un nom qui dit à quoi elle sert —
production-agent,staging-bot. - Listez éventuellement des cubes autorisés, séparés par des virgules, pour confiner la clé à ceux-là. Laissez vide et la clé atteint tous les cubes du tenant.
- Cliquez sur Créer.
- Copiez le secret immédiatement — il n’est affiché qu’une fois. Ensuite le dashboard ne garde que le nom et le préfixe visible.
Faire une requête
Envoyez la clé dans l’en-tête Authorization :
curl https://api.saiku.bi/me/tenant \ -H "Authorization: Bearer sk_abc123…"Réponse en cas de succès :
{ "tenantId": "81e301f2-…", "tenantSlug": "acme", "tier": "team", "connectionName": "production-warehouse"}Découvrir la surface
GET /me renvoie la liste des points d’entrée qui vous sont
disponibles — un petit index à interroger d’abord plutôt que de coder
les chemins en dur :
{ "endpoints": [ "/me/tenant", "/me/tenant/deletion", "/me/upstream", "/me/limits", "/me/cubes", "/me/analyze/cubes", "/me/members", "/me/workspaces", "/me/api-keys", "/me/invites", "/me/audit", "/me/usage", "/me/schemas" ]}Limites de débit
Deux seaux — un budget de rafale par minute et un budget soutenu par heure. Ils sont par tenant, pas par clé : répartir le trafic sur plusieurs clés partage un seul budget au lieu de le multiplier.
| Palier | Par minute | Par heure |
|---|---|---|
| Starter | 60 | 1 000 |
| Team | 300 | 10 000 |
| Business | 1 000 | 50 000 |
| Enterprise | Sur mesure | Sur mesure |
Ne codez pas ces chiffres en dur — demandez. GET /me/limits vous
dit ce qui s’applique réellement à votre clé :
{ "enabled": true, "profile": "starter-default", "perMinute": 60, "perHour": 1000 }Chaque réponse porte votre budget restant, vous pouvez donc lever le pied avant d’être refusé plutôt qu’après :
X-RateLimit-Remaining-Minute: 60X-RateLimit-Remaining-Hour: 1000Surveiller ces deux en-têtes fait la différence entre une intégration
bien élevée et une qui découvre la limite en la percutant. Quand vous
la touchez malgré tout, vous recevez 429 Too Many Requests avec un
en-tête Retry-After indiquant quand revenir.
Le payer — le 402 couvre presque tout
Presque toute la surface /me/* exige un abonnement actif. « Actif »
est généreux — trialing et même past-due comptent tous les
deux, une carte en échec ne coupe donc pas votre intégration en plein
réessai. Quand il n’y a réellement plus d’abonnement, chaque point
d’entrée facturé répond 402.
Quatre chemins restent ouverts quoi qu’il arrive, et ce sont ceux qui doivent l’être :
| Exempté | Pourquoi |
|---|---|
/me/billing/* | Il faut bien pouvoir s’abonner au départ. |
/me/tenant | Le dashboard a besoin de votre identité ne serait-ce que pour s’afficher. |
/me/account | Supprimer votre compte est un droit inconditionnel, payant ou non. |
/me/invites/* | Accepter une invitation se produit avant d’avoir un tenant payant. |
Si votre intégration se met à renvoyer 402 sur toute la ligne, c’est
ce qui s’est produit — regardez GET /me/billing/state plutôt que votre clé.
Forme de la réponse d’erreur
Toute réponse d’erreur est du 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 |
|---|---|---|
400 | variable | Requête incorrecte. Le code nomme le problème précis — missing_workspace, invalid_bucket — et message dit ce qui était attendu. |
401 | unauthorized | Clé API absente ou invalide |
402 | payment_required | Pas d’abonnement actif — voir plus haut ce qui est exempté |
403 | forbidden | Clé API valide mais sans permission sur 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 |
Faire tourner une clé
- Sur la page Clés API, cliquez sur Créer une clé pour en émettre une nouvelle. Donnez-lui le même libellé que celle que vous remplacez.
- Mettez votre agent / intégration à jour pour utiliser la nouvelle clé.
- Une fois confirmé que la nouvelle fonctionne en production, retournez sur la page Clés API et révoquez l’ancienne.
Il n’y a pas d’interruption — les deux clés sont valides en même temps jusqu’à ce que vous révoquiez l’ancienne.
La suite
- Utilisez l’API de facturation pour gérer votre abonnement par programme.
- Lisez sur l’isolation des tenants pour comprendre ce qu’une clé API peut et ne peut pas atteindre.