Uwierzytelnianie

API Saiku Cloud używa uwierzytelniania przez token Bearer. Każde żądanie do https://api.saiku.bi/me/* niesie klucz API, który identyfikuje Twojego tenanta.

Wskazówka

Podłączasz klienta czatu LLM (Claude Desktop, claude.ai, Cursor) do serwera MCP? Tacy klienci nie potrzebują klucza API — uwierzytelniają się przez konektor OAuth 2.1 (samoobsługowy, plan Team i wyższe). Zobacz Podłączanie agenta. Klucze API służą do dostępu programistycznego i REST.

Bazowy URL

https://api.saiku.bi

Generowanie klucza API

Wskazówka

Każdy klucz API jest powiązany z Twoim tenantem po stronie serwera. Nie udostępniaj kluczy poza zespołem — rotuj natychmiast, jeśli klucz kiedykolwiek wyciekł.

1. Otwórz stronę kluczy API z paska bocznego dashboarda.
2. Kliknij Utwórz klucz.
3. Nadaj kluczowi etykietę (np. production-agent, staging-bot).
4. Skopiuj sekret natychmiast — pokazujemy go tylko raz. Po tym momencie dashboard pokazuje już tylko ID klucza + etykietę.

Wykonywanie żądania

Wyślij klucz w nagłówku Authorization:

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

Udana odpowiedź:

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

Limity szybkości

Limity szybkości obowiązują na tenanta, nie na klucz. Limity skalują się z Twoim planem:

Plan	Na minutę	Na godzinę
Starter	60	1 000
Team	300	10 000
Business	1 000	50 000
Enterprise	Indywidualne	Indywidualne

Gdy uderzysz w limit, zwracamy 429 Too Many Requests z nagłówkiem Retry-After wskazującym, kiedy spróbować ponownie.

Kształt odpowiedzi błędu

Każda odpowiedź błędu to JSON:

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

Najczęstsze kody błędów:

Status	Kod	Znaczenie
401	unauthorized	Brak klucza API lub klucz nieprawidłowy
402	payment_required	Tenant nie ma aktywnej subskrypcji
403	forbidden	Klucz API ważny, ale brak uprawnień do tego zasobu
404	not_found	Zasób nie istnieje (lub nie jest widoczny dla Twojego tenanta)
429	rate_limited	Przekroczony limit na minutę lub godzinę

Rotacja klucza

1. Na stronie kluczy API kliknij Utwórz klucz, by wygenerować nowy. Nadaj mu tę samą etykietę co kluczowi, który rotujesz.
2. Zaktualizuj agenta / integrację, by używał nowego klucza.
3. Gdy potwierdzisz, że nowy klucz działa w produkcji, wróć na stronę kluczy API i unieważnij stary.

Nie ma przestoju — oba klucze są ważne jednocześnie, dopóki nie unieważnisz starego.

Co dalej

• Użyj API rozliczeń, by programistycznie zarządzać subskrypcją.
• Przeczytaj o izolacji tenantów, by zrozumieć, do czego klucz API może i nie może dotrzeć.