API
API błędy i limity
Błędy Content API mają stabilny kształt JSON, kod maszynowy i correlation_id.
- Aktualizacja
- 2026-04-19
- Dostępność
- Płatne plany
Kształt błędu
json
{
"error": "Human-readable message",
"code": "RATE_LIMITED",
"correlation_id": "uuid"
}Statusy
| HTTP | Kod | Co zrobić |
|---|---|---|
| 400 | INVALID_QUERY_PARAMS | Popraw parametry zapytania. |
| 401 | MISSING_TOKEN / INVALID_TOKEN / TOKEN_EXPIRED | Sprawdź token Bearer i wymianę tokenów. |
| 403 | TOKEN_PROJECT_MISMATCH / PROJECT_NOT_ENTITLED | Sprawdź projekt, plan i stan rozliczeń. |
| 404 | CONTENT_NOT_FOUND | Sprawdź ID albo stan elementu treści. |
| 429 | RATE_LIMITED | Zastosuj Retry-After i poczekaj do resetu. |
Limity zapytań
- 1000 żądań dziennie na projekt.
- Okno limitu jest liczone według dnia UTC.
- Liczone są odpowiedzi 200, 304, 400 i 404 po przejściu kontroli uwierzytelnienia, projektu i uprawnienia.
- Nagłówki: X-RateLimit-Limit, X-RateLimit-Remaining, X-RateLimit-Reset, Retry-After dla 429.
Wróć do endpointów
Najpierw zbuduj synchronizację listy i szczegółów, potem dodaj pamięć podręczną i ponowienia.