developers  · docsKonto
Hent tokenet ditt
Docs · Grenser og fair use

Grenser og fair use

Oppdatert Aug 2026 · API v3

Grensene finnes for å holde API-et friskt for alle — normal bruk berører dem aldri.

Rate limits

  • Offentlig API-trafikk: som standard 60 forespørsler/minutt per klient+bruker.
  • I tillegg gjelder infrastrukturgrenser per IP — vanlige integrasjoner når dem aldri.
  • Treffer du en grense, svarer 429 med en Retry-After-header; X-Rate-Limit-*-headerne forteller deg til enhver tid hvor du står.

Fair use

Utover de harde per-minutt-grensene finnes en myk månedsveiledning: 3 000 requests/måned (les gjeldende verdi live fra GET /v3/users/me/usage som fairUse.monthlyReference). Den er en måler, ikke en håndheving: overskrider du den, endres en farge på bruks-siden din på my.pon.app, ikke noe mer. Live-tallene dine (i dag, måned, per token) finner du der også.

Den billigste requesten er den du ikke gjør.

Webhooks forteller deg når noe endret seg; en betinget fetch etterpå er alt du trenger. Det holder de fleste integrasjoner langt under veiledningen.

Ressurskvoter

Rause tak mot løpsk automatisering (422 QUOTA_EXCEEDED med details.resource og details.limit):

Ressurs Grense
Egne lister 200
Aktive varer per liste 5 000 (LIST_FULL)
Bilder 2 000
Åpne invitasjoner per liste 50
Listemedlemskap 500
Personal Access Tokens 10 (TOKEN_LIMIT)
Webhooks 5 (WEBHOOK_LIMIT)

Feilkonvolutten

Hver feil, hvert endepunkt, samme form:

{ "errors": [ { "code": "LIST_FULL", "message": "…", "details": { "limit": 5000 } } ] }

Vellykkede svar er alltid { "data": …, "meta": … }. Skrivestier er idempotens-vennlige — å prøve en feilet skriving på nytt er trygt.