Authentifizierung

Die Saiku Cloud API verwendet Bearer-Token-Authentifizierung. Jede Anfrage an https://api.saiku.bi/me/* enthält einen API-Key, der Ihren Tenant identifiziert.

Basis-URL

https://api.saiku.bi

Einen API-Key erzeugen

Öffnen Sie die API-Keys-Seite aus der Dashboard-Seitenleiste.
Klicken Sie auf Key erstellen.
Geben Sie dem Key ein Label (z. B. production-agent, staging-bot).
Kopieren Sie das Secret sofort — wir zeigen es nur einmal an. Nach diesem Zeitpunkt zeigt das Dashboard nur noch die Key-ID + das Label.

Eine Anfrage stellen

Senden Sie den Key im Authorization-Header:

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

Erfolgreiche Antwort:

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

Rate-Limits

Rate-Limits gelten pro Tenant, nicht pro Key. Die Limits skalieren mit Ihrem Plan:

Plan	Pro Minute	Pro Stunde
Starter	60	1 000
Team	300	10 000
Business	1 000	50 000
Enterprise	individuell	individuell

Wenn Sie ein Limit erreichen, geben wir 429 Too Many Requests mit einem Retry-After-Header zurück, der angibt, wann erneut versucht werden soll.

Format der Fehlerantwort

Jede Fehlerantwort ist JSON:

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

Häufige Fehlercodes:

Status	Code	Bedeutung
`401`	`unauthorized`	API-Key fehlt oder ist ungültig
`402`	`payment_required`	Tenant hat kein aktives Abonnement
`403`	`forbidden`	API-Key gültig, aber ohne Berechtigung für diese Ressource
`404`	`not_found`	Ressource existiert nicht (oder ist für Ihren Tenant nicht sichtbar)
`429`	`rate_limited`	Limit pro Minute oder pro Stunde überschritten

Einen Key rotieren

Klicken Sie auf der API-Keys-Seite auf Key erstellen, um einen neuen zu erzeugen. Geben Sie ihm dasselbe Label wie dem Key, den Sie rotieren.
Aktualisieren Sie Ihren Agenten / Ihre Integration, um den neuen Key zu verwenden.
Nachdem Sie bestätigt haben, dass der neue Key in Produktion funktioniert, kehren Sie zur API-Keys-Seite zurück und widerrufen Sie den alten.

Es gibt keine Ausfallzeit — beide Keys sind gleichzeitig gültig, bis Sie den alten widerrufen.

Wie geht es weiter?

Verwenden Sie die Billing API, um Ihr Abonnement programmatisch zu verwalten.
Lesen Sie über Tenant-Isolation, um zu verstehen, was ein API-Key erreichen kann und was nicht.