> ## Documentation Index
> Fetch the complete documentation index at: https://docs.wappfy.io/llms.txt
> Use this file to discover all available pages before exploring further.

# Ratenlimits

> API-Ratenlimit-Richtlinien und Umgang mit Ratenlimit-Fehlern.

# 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    |

## Ratenlimit-Header

Jede Antwort enthaelt Informationen zum Ratenlimit:

```http theme={null}
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:

```json theme={null}
{
  "success": false,
  "error": {
    "code": "RATE_LIMIT_EXCEEDED",
    "message": "Too many requests, please try again later"
  }
}
```

### Best Practices

<AccordionGroup>
  <Accordion title="Exponentielles Backoff implementieren">
    Wenn Sie eine 429-Antwort erhalten, warten Sie und versuchen Sie es erneut mit steigenden Verzoegerungen: 1s, 2s, 4s, 8s...
  </Accordion>

  <Accordion title="Den Reset-Header verwenden">
    Pruefen Sie `X-RateLimit-Reset`, um genau zu wissen, wann Sie fortfahren koennen.
  </Accordion>

  <Accordion title="Operationen moeglichst buendeln">
    Senden Sie Nachrichten mit angemessenen Pausen dazwischen, anstatt sie gebuendelt abzusenden.
  </Accordion>

  <Accordion title="Antworten zwischenspeichern">
    Vermeiden Sie das erneute Abrufen von Daten, die sich nicht geaendert haben (z.B. Instanzdetails, Kontaktinformationen).
  </Accordion>
</AccordionGroup>