# Ratenbegrenzungen

> Das Budget pro Schlüssel, der eine Header, der es beschreibt, und wie Sie darunter bleiben.

Source: https://developers.backresto.com/de/docs/rate-limits

Die Partner-API erlaubt **300 Anfragen pro Minute und Schlüssel**. Das Fenster
ist eine gleitende Minute, und das Budget gehört zum Schlüssel und nicht zum
Restaurant oder zu Ihrem Unternehmen; zwei Deployments mit zwei Schlüsseln haben
also zwei Budgets. Der [MCP-Endpunkt](https://developers.backresto.com/de/docs/mcp) zieht aus demselben Budget: Ein
Tool-Aufruf ist eine Anfrage.

Wer darüber hinausgeht, bekommt `429` mit einem Problemdokument vom Typ
`rate-limit-exceeded` und einem `Retry-After`-Header, der die Anzahl der
Sekunden angibt, bis sich das Budget wieder füllt. Warten Sie sie ab; versuchen
Sie es nicht früher erneut, denn eine Anfrage, die zu früh eintrifft, verbraucht
Budget, ohne zu gelingen.

`Retry-After` ist der einzige Budget-Header. Es gibt kein
`X-RateLimit-Remaining`, das Sie beobachten könnten; takten Sie Ihren Client
also über den Entwurf und nicht über das Ablesen eines Zählers. Die
Gewohnheiten unten sind dieser Entwurf.

## Bequem darunter bleiben

Drei Gewohnheiten decken fast jede Integration ab:

**Fragen Sie volle Seiten an.** `limit=100` durchläuft dieselbe Collection mit
einem Viertel der Anfragen, die `limit=25` braucht. Was eine Anfrage kostet,
ist die Anfrage, nicht die Zahl der Zeilen.

**Holen Sie Dateien nur, wenn Sie sie brauchen.** Der Datensatz eines Bildes
sagt bereits in `data.asset`, was die Datei ist: Typ, Größe und Digest. Rufen Sie
den Assets-Endpunkt für die Bilder auf, die Sie gleich anzeigen oder speichern,
nicht für jeden Datensatz eines Durchlaufs, und überspringen Sie die, deren
`sha256` Sie schon haben.

**Serialisieren Sie einen Backfill.** Ein Jahr Historie mit zehn parallelen
Workern zu durchlaufen ist die eine Form, die zuverlässig ans Limit stößt. Ein
einzelner Worker mit `limit=100` kommt in ein paar Minuten durch das Jahr eines
gut besuchten Restaurants.

## Wenn Sie wirklich mehr brauchen

Sagen Sie uns, worin die Last besteht. Das Limit existiert, damit ein einzelner
sich schlecht benehmender Client den Dienst nicht für das Restaurant
verschlechtert, dessen Daten es sind, und nicht, um Zugriff zu rationieren; eine
beschriebene, berechtigte Last ist ein Gespräch, keine Absage.

## Die anderen Grenzen, die man kennen sollte

| Grenze | Wert |
| --- | --- |
| Anfragen pro Schlüssel | 300 pro Minute |
| Seitengröße | 100 Datensätze |
| Lebensdauer signierter URLs, Fotos und Dateien | 15 Minuten |
| Aktive Schlüssel pro Konto | 10 |

Diese setzt die API durch, statt sie nur zu beschreiben: Wer eine der ersten
beiden überschreitet, bekommt `429` oder `400`, statt stillschweigend abgeschnitten
zu werden.