Klucze API
Wszystkie requesty API wymagają tokenu Bearer w nagłówku Authorization:
Authorization: Bearer sk-TWOJ_KLUCZ_API
sk- i tworzy się je w Panelu w Ustawienia → Klucze API.
Klucze API są pokazywane tylko raz przy tworzeniu. Przechowuj je bezpiecznie.
Wymagana rola
Dostęp do API wymaga roli Moderator lub wyższej w zespole. Użytkownicy z rolą USER otrzymają odpowiedź 403 Forbidden.
| Rola | Dostęp do API |
|---|
| User | Nie |
| Moderator | Tak |
| Administrator | Tak |
Limity tokenów
Każde wywołanie API zużywa tokeny z subskrypcji zespołu. System egzekwuje limity:
- Przed każdym requestem: Sprawdzana jest dostępność tokenów
- Po każdym requestem: Rzeczywiste zużycie jest śledzone i odliczane
Gdy limit tokenów zostanie przekroczony, API zwraca 429 Too Many Requests:
{
"error": "Token limit exceeded",
"remaining": 0,
"reason": "Monthly token quota exhausted"
}
Kody błędów
| 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 |
