Ratenlimits

Die Wappfy API setzt Ratenlimits durch, um eine faire Nutzung und Plattformstabilitaet zu gewaehrleisten.

Standard-Limits

Geltungsbereich	Limit	Zeitfenster
Pro Benutzer	100 Anfragen	1 Minute
Pro IP (nicht authentifiziert)	20 Anfragen	1 Minute

Jede Antwort enthaelt Informationen zum Ratenlimit:

X-RateLimit-Limit: 100
X-RateLimit-Remaining: 87
X-RateLimit-Reset: 1707580800

Header	Beschreibung
`X-RateLimit-Limit`	Maximale Anzahl erlaubter Anfragen im Zeitfenster
`X-RateLimit-Remaining`	Verbleibende Anfragen im aktuellen Zeitfenster
`X-RateLimit-Reset`	Unix-Zeitstempel, wann das Zeitfenster zurueckgesetzt wird

Wenn Sie das Limit ueberschreiten, erhalten Sie eine 429-Antwort:

{
  "success": false,
  "error": {
    "code": "RATE_LIMIT_EXCEEDED",
    "message": "Too many requests, please try again later"
  }
}

Exponentielles Backoff implementieren

Wenn Sie eine 429-Antwort erhalten, warten Sie und versuchen Sie es erneut mit steigenden Verzoegerungen: 1s, 2s, 4s, 8s…

Den Reset-Header verwenden

Pruefen Sie X-RateLimit-Reset, um genau zu wissen, wann Sie fortfahren koennen.

Operationen moeglichst buendeln

Senden Sie Nachrichten mit angemessenen Pausen dazwischen, anstatt sie gebuendelt abzusenden.

Antworten zwischenspeichern

Vermeiden Sie das erneute Abrufen von Daten, die sich nicht geaendert haben (z.B. Instanzdetails, Kontaktinformationen).