Rate-Limits & Kontingente
Gestufte Grenzen je IP, Person und Key sowie Tages-Kontingente.
Die API begrenzt die Aufrufrate gestuft (ADR-0105). Grenzen gelten je IP (anonym), je Person (angemeldet) und je Key bzw. OAuth-Client.
Startwerte
Werte sind je Mandant konfigurierbar, nach oben durch eine Plattform-Obergrenze gedeckelt. Die folgenden Startwerte gelten als Richtgroesse; die Einfuehrung erfolgt erst nach 1–2 Wochen Schattenmodus auf staging.
| Klasse | Grenze |
|---|---|
| anonym (je IP) | 60 / min |
| angemeldet (je Person) | 600 / min |
| je Key/Client | 300 / min + 50.000 / Tag |
| Login | 10 / 15 min |
| Suche (je Person) | 60 / min |
| Export (je Person) | 10 / h |
Strengere Grenzen gelten fuer die Endpunkt-Klassen Login, Suche, Export.
Eigenes Limit je Schlüssel
Jeder API-Schlüssel kann zusätzlich ein eigenes Limit tragen (je Minute und je
Kalendertag, UTC), gesetzt beim Anlegen oder Bearbeiten. Es darf den Wert des Mandanten
nicht übersteigen und gilt zusätzlich zu den Grenzen oben. Bei Überschreitung:
429 API_KEY_RATE_LIMITED mit Retry-After. Mehr: API-Schlüssel – Umfang & Regeln.
Antwort bei Ueberschreitung
Wird eine Grenze erreicht, antwortet die API mit 429 Too Many Requests als Problem
Details — nie mit 500. Die Antwort traegt Retry-After (Sekunden) und RateLimit-*-Header.
HTTP/1.1 429 Too Many Requests
Retry-After: 30
RateLimit-Remaining: 0
Content-Type: application/problem+json{
"type": "https://docs.example/errors/RATE_LIMITED",
"title": "Zu viele Anfragen",
"status": 429,
"code": "RATE_LIMITED",
"detail": "Tages-Kontingent des Keys erschoepft.",
"traceId": "01JABCDEF"
}Empfehlung
Retry-Afterrespektieren und mit exponentiellem Backoff erneut versuchen.RateLimit-Remainingbeobachten und Lastspitzen glaetten.- Fuer grosse Lesemengen die Cursor-Pagination nutzen statt eng getakteter Einzelabrufe.