Ratenlimits

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

Geltungsbereich

Limit

Zeitfenster

Pro Benutzer

100 Anfragen

1 Minute

Pro IP (nicht authentifiziert)

20 Anfragen

1 Minute

Ratenlimit-Header

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

Umgang mit Ratenlimits

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"
  }
}

Best Practices

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).

Standard-Limits