developers · docsKontoLimity i fair use
Zaktualizowano Aug 2026 · API v3Limity istnieją po to, żeby API było zdrowe dla wszystkich — normalne użycie nigdy ich nie dotyka.
Rate limity
- Ruch publicznego API: domyślnie 60 żądań/minutę na klienta+użytkownika.
- Dodatkowo obowiązują limity infrastrukturalne na IP — normalne integracje nigdy ich nie osiągają.
- Trafienie w limit odpowiada
429z nagłówkiemRetry-After; nagłówkiX-Rate-Limit-*w każdej chwili mówią Ci, na czym stoisz.
Fair use
Poza twardymi limitami na minutę istnieje miękki miesięczny punkt
odniesienia: 3 000 requestów/miesiąc (aktualną wartość czytaj na żywo z
GET /v3/users/me/usage jako fairUse.monthlyReference). To
wskaźnik, nie egzekwowanie: przekroczenie zmienia kolor na Twojej stronie
użycia na my.pon.app, nic więcej. Twoje bieżące liczby (dziś, miesiąc, per
token) też tam są.
Najtańszy request to ten, którego nie robisz.
Webhooki mówią Ci, kiedy coś się zmieniło; warunkowy fetch chwilę później to wszystko, czego potrzebujesz. Dzięki temu większość integracji zostaje daleko poniżej punktu odniesienia.Kwoty zasobów
Hojne limity przeciwko rozpędzonej automatyzacji (422 QUOTA_EXCEEDED z
details.resource i details.limit):
| Zasób | Limit |
|---|---|
| Własne listy | 200 |
| Aktywne produkty na listę | 5 000 (LIST_FULL) |
| Obrazy | 2 000 |
| Otwarte zaproszenia na listę | 50 |
| Członkostwa w listach | 500 |
| Personal access tokeny | 10 (TOKEN_LIMIT) |
| Webhooki | 5 (WEBHOOK_LIMIT) |
Koperta błędów
Każdy błąd, każdy endpoint, ten sam kształt:
{ "errors": [ { "code": "LIST_FULL", "message": "…", "details": { "limit": 5000 } } ] }Udane odpowiedzi to zawsze { "data": …, "meta": … }. Ścieżki zapisu są
przyjazne idempotencji — ponowienie nieudanego zapisu jest bezpieczne.