# Limity API i obsługa błędów

> Limity API widżetu, kody błędów i format odpowiedzi z błędem.

## Limity

- Maksymalna długość wiadomości: 4000 znaków.
- Wiadomości (`/message`): 80 żądań na minutę.
- Wszystkie endpointy razem: 900 żądań na 15 minut.
- Endpoint `/message` wymaga `session_id`. Jeśli podana sesja nie istnieje, powstaje nowa, a odpowiedź zawiera jej identyfikator i historię.

## Kody błędów

| Status | Błąd | Co zrobić |
|---|---|---|
| 400 | Brak `session_id` lub `message`, wiadomość za długa | Popraw treść żądania |
| 401 | `Widget token is required` | Dodaj nagłówek `Authorization: Bearer TWOJ_TOKEN` |
| 401 | `Invalid or expired widget token` | Sprawdź token w aplikacji: **Agent AI** → **Instalacja** |
| 402 | Brak środków w planie | Sprawdź plan i limity workspace |
| 429 | Przekroczony limit zapytań | Odczekaj chwilę i ponów żądanie |
| 500 | Błąd serwera | Ponów żądanie; jeśli błąd się powtarza, napisz do nas |

## Format błędu

```json
{
  "error": "Invalid or expired widget token"
}
```

W trybie strumieniowym błąd przychodzi jako zdarzenie `error` z polami `status`, `code` i `error`.