Docs · Limits & Fair Use

Limits & Fair Use

Aktualisiert Aug 2026 · API v3

Die Limits gibt es, damit die API für alle gesund bleibt — normale Nutzung berührt sie nie.

Rate-Limits

Public-API-Traffic: standardmäßig 60 Requests/Minute pro Client+Nutzer.
Darüber hinaus greifen Infrastruktur-Limits pro IP — normale Integrationen erreichen sie nie.
Wer ein Limit reißt, bekommt 429 mit einem Retry-After-Header; die X-Rate-Limit-*-Header sagen dir jederzeit, wo du stehst.

Fair Use

Jenseits der harten Minuten-Limits gibt es einen weichen Monats-Richtwert: 3.000 Requests/Monat (lies den aktuellen Wert live aus GET /v3/users/me/usage als fairUse.monthlyReference). Er ist eine Anzeige, keine Durchsetzung: Ihn zu überschreiten ändert eine Farbe auf deiner Nutzungsseite auf my.pon.app, sonst nichts. Deine Live-Zahlen (heute, Monat, pro Token) stehen dort auch.

Der günstigste Request ist der, den du nicht machst.

Webhooks sagen dir, wann sich etwas geändert hat; ein bedingter Fetch danach ist alles, was du brauchst. Damit bleiben die meisten Integrationen weit unter dem Richtwert.

Ressourcen-Quotas

Großzügige Obergrenzen gegen außer Kontrolle geratene Automatisierung (422 QUOTA_EXCEEDED mit details.resource und details.limit):

Ressource	Limit
Eigene Listen	200
Aktive Artikel pro Liste	5.000 (`LIST_FULL`)
Bilder	2.000
Offene Einladungen pro Liste	50
Listen-Mitgliedschaften	500
Personal Access Tokens	10 (`TOKEN_LIMIT`)
Webhooks	5 (`WEBHOOK_LIMIT`)

Der Fehler-Umschlag

Jeder Fehler, jeder Endpunkt, dieselbe Form:

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

Erfolgreiche Antworten sind immer { "data": …, "meta": … }. Schreibpfade sind idempotenz-freundlich — einen fehlgeschlagenen Schreibvorgang zu wiederholen ist sicher.

Zurück← Webhooks WeiterAPI-Referenz →