Grenzen und Kontingent
| Je Minute | 60 Aufrufe je Schlüssel. Gilt für alle Bereiche zusammen. |
| Tageslimit | Standardmäßig 5.000 Abrufe je Zugang. Der für dich geltende Wert steht im Portal. |
| Zählung | Je Bereich getrennt gezählt, das Limit gilt für die Summe. |
| Zurücksetzen | Täglich um Mitternacht. |
| Fehlgeschlagene Aufrufe | Kosten kein Tageskontingent.
Nur erfolgreiche Antworten mit HTTP 2xx werden gezählt.
Die Minutenbremse berücksichtigt auch Fehler, um wiederholte
ungültige Anfragen zu begrenzen. |
| Erhöhung | Formlos per E-Mail, mit kurzer Begründung. In der Regel unkompliziert. |
Empfohlenes Abrufmuster
Das Tageslimit ist großzügig, aber ein Abruf je Seitenaufruf deiner Besucher wäre die falsche Bauweise. Unsere Daten ändern sich einmal täglich, deshalb:
- Hole die Deals einmal täglich gebündelt und lege sie
bei dir ab. Ein Durchlauf über 74.000 Deals mit
limit=500sind rund 150 Aufrufe. - Der Verlauf eines Artikels ändert sich höchstens einmal am Tag. Cache ihn entsprechend.
- Der Kategorie-Baum ändert sich selten. Einmal wöchentlich genügt.
Wenn das Limit erreicht ist
Weitere Aufrufe werden mit 429 und dem Code
tageslimit_erreicht abgewiesen, bis das Limit um Mitternacht
zurückgesetzt wird. Details unter
Fehlerbehandlung.
Retry-After
Jede 429 trägt den Kopf Retry-After mit der
Wartezeit in Sekunden — 60 bei der Minutenbremse, bei
tageslimit_erreicht die Sekunden bis Mitternacht. Lies den Kopf
aus, statt eine Wartezeit zu raten.
HTTP/1.1 429 Too Many Requests
Retry-After: 60
Content-Type: application/jsonWie die Minutenbremse zählt
Gezählt wird je Schlüssel, nicht je IP-Adresse, in einem gleitenden Fenster von 60 Sekunden. Mehrere Rechner, die denselben Schlüssel benutzen, teilen sich also das Kontingent. Wer parallel abrufen will, nimmt dafür besser mehrere Schlüssel — im Portal lassen sich bis zu fünf gleichzeitig führen.