Uwierzytelnianie

Klucze API

Wszystkie requesty API wymagają tokenu Bearer w nagłówku Authorization:

Authorization: Bearer sk-TWOJ_KLUCZ_API

Klucze API zaczynają się od sk- i tworzy się je w Panelu w Ustawienia → Klucze API.

Klucze API są pokazywane tylko raz przy tworzeniu. Przechowuj je bezpiecznie.

Dostęp do API wymaga roli Moderator lub wyższej w zespole. Użytkownicy z rolą USER otrzymają odpowiedź 403 Forbidden.

Każde wywołanie API zużywa tokeny z subskrypcji zespołu. System egzekwuje limity:

Gdy limit tokenów zostanie przekroczony, API zwraca 429 Too Many Requests:

{
  "error": "Token limit exceeded",
  "remaining": 0,
  "reason": "Monthly token quota exhausted"
}

Status	Znaczenie
`401 Unauthorized`	Brakujący lub nieprawidłowy klucz API
`403 Forbidden`	Niewystarczająca rola użytkownika (wymagany Moderator+)
`404 Not Found`	Kolekcja nie znaleziona lub nie należy do Twojego zespołu
`429 Too Many Requests`	Przekroczony limit tokenów