Limits
Anfragen pro Minute, Upload-Grenzen und Größen von Anfragen.
| Grenze | Wert |
|---|---|
| Anfragen je Schlüssel | 60 pro Minute |
| Anfragen je Firma, alle Schlüssel zusammen | 120 pro Minute |
| Uploads je Firma | 10 pro Minute |
| Gleichzeitige Uploads je Firma | höchstens 2 |
| Größe einer Datei beim Upload | 30 MiB |
| Größe einer Upload-Anfrage (gesamt) | 31 MiB |
| Größe einer JSON-Anfrage | 1 MiB |
Treffer je Seite (limit) | höchstens 1.000 |
Startposition (offset) | höchstens 1.000.000 |
| Anfragen mit ungültigem Schlüssel je Client | 120 pro Minute |
Wartezeit nach 429 (Retry-After) | 60 Sekunden |
Die Werte sind die aktuellen technischen Schutzgrenzen. Anpassungen richten sich nach Ziffer 5.4, 8.2 und 10 der AGB.
So wirken die Grenzen
- Anfragen: Die Zähler laufen je Minute. Jeder Schlüssel hat ein eigenes Budget; zusätzlich teilen sich alle Schlüssel einer Firma ein gemeinsames Budget.
- Uploads: Uploads zählen zu den Anfragen und haben ein eigenes Budget je Firma. Außerdem laufen nur wenige Uploads einer Firma gleichzeitig.
- Ungültige Schlüssel: Anfragen mit ungültigem, unbekanntem oder falsch gesendetem Schlüssel sind je Client (IP-Adresse) begrenzt. Das schützt vor dem Durchprobieren von Schlüsseln.
- Größe: Anfragen über der erlaubten Größe lehnt die API mit
413ab. Eine einzelne zu große Datei im Upload ergibt400. - Filter:
limitundoffsethaben Höchstwerte, siehe Filtern und Paginieren.
Wenn eine Grenze erreicht ist
Die API antwortet mit 429 und dem Code APIRateLimit. Der Header Retry-After nennt die Wartezeit in Sekunden. Warte diese Zeit ab und wiederhole die Anfrage dann; Uploads mit derselben X-Upload-Request-Id.
Plane Abrufe so, dass sie gleichmäßig verteilt laufen, statt viele Anfragen auf einmal zu senden. Frage große Datenmengen seitenweise mit dem höchsten erlaubten limit ab.