Gränser och fair use
Uppdaterad Aug 2026 · API v3Gränserna finns för att hålla API:et friskt för alla — normal användning nuddar dem aldrig.
Rate limits
- Publik API-trafik: som standard 60 förfrågningar/minut per klient+användare.
- Dessutom gäller infrastrukturgränser per IP — vanliga integrationer når dem aldrig.
- Att slå i en gräns svarar
429med enRetry-After-header; headrarnaX-Rate-Limit-*visar när som helst var du ligger.
Fair use
Utöver de hårda per-minut-gränserna finns en mjuk månadsriktlinje:
3 000 förfrågningar/månad (läs det aktuella värdet live från
GET /v3/users/me/usage som fairUse.monthlyReference). Den är en mätare,
inte en spärr: att överskrida den ändrar en färg på din användningssida på
my.pon.app, inget mer. Dina live-siffror (idag, månad, per token) finns
också där.
Den billigaste förfrågan är den du inte gör.
Webhooks berättar när något har ändrats; en villkorad hämtning efteråt är allt du behöver. Det håller de flesta integrationer långt under riktlinjen.Resurskvoter
Generösa tak mot skenande automatisering (422 QUOTA_EXCEEDED med
details.resource och details.limit):
| Resurs | Gräns |
|---|---|
| Egna listor | 200 |
| Aktiva varor per lista | 5 000 (LIST_FULL) |
| Bilder | 2 000 |
| Öppna inbjudningar per lista | 50 |
| Listmedlemskap | 500 |
| Personliga åtkomsttoken | 10 (TOKEN_LIMIT) |
| Webhooks | 5 (WEBHOOK_LIMIT) |
Felkuvertet
Varje fel, varje endpoint, samma form:
{ "errors": [ { "code": "LIST_FULL", "message": "…", "details": { "limit": 5000 } } ] }
Lyckade svar är alltid { "data": …, "meta": … }. Skrivvägarna är
idempotens-vänliga — att försöka om en misslyckad skrivning är säkert.