Mit Paginierung rufen Sie einen Produkt-Feed in Teilen ab, statt alle Produkte in einer Antwort. Kombinieren Sie sie mit Filtern, um nur die Produkte abzurufen, die Sie brauchen.
Bitte beachten: Paginierung funktioniert nur mit einer Kampagne pro Anfrage. Wenn Sie records mit mehreren program_id[]-Werten kombinieren, erhalten Sie einen 400-Fehler. Verwenden Sie für jede Kampagne eine eigene Feed-URL.
Wann Sie Paginierung verwenden
Immer. Ohne den Parameter records erhalten Sie den kompletten Produkt-Feed in einer Antwort. Bei großen Feeds können das Hunderte Megabyte oder mehr sein. Eine einzelne Anfrage bricht nach etwa 5 Minuten ab, ein großer Feed ohne Paginierung ist dann unvollständig.
So verwenden Sie die Paginierung
- Fügen Sie der Feed-URL
&records=1000hinzu. Sie erhalten die ersten 1000 Produkte. - Lesen Sie den Antwort-Header
X-Next-Urlaus. Er enthält die vollständige URL der nächsten Seite. - Rufen Sie diese URL ab, um die nächsten 1000 Produkte zu erhalten.
- Wiederholen Sie das, bis die Antwort keinen
X-Next-Url-Header mehr enthält. Dann haben Sie alle Produkte.
Verwenden Sie die X-Next-Url immer genau so, wie Sie sie erhalten. Sie enthält einen search_after-Wert, der auf das letzte Produkt der vorherigen Seite verweist. Sie können ihn also nicht selbst berechnen. Das bedeutet auch, dass Ihre Software Antwort-Header auslesen können muss. Ist das nicht möglich, verwenden Sie Filter, um den Feed klein zu halten.
Jede Antwort enthält außerdem:
- X-Current-Count: die Anzahl der Produkte auf dieser Seite. Das ist der von Ihnen angeforderte Wert, außer auf der letzten Seite.
- X-Total-Count: die Gesamtzahl der Produkte im Feed. Damit können Sie prüfen, ob Sie alle Produkte erhalten haben.
Paginierung und das Rate Limit
Jede Seite zählt als Anfrage für das Rate Limit von 30 Anfragen pro Minute pro IP-Adresse. Rufen Sie Seiten nacheinander ab, nie gleichzeitig. Wenn Sie eine 429-Antwort erhalten, warten Sie die Anzahl Sekunden aus dem Retry-After-Header ab, bevor Sie die nächste Seite abrufen. Mehr dazu lesen Sie in Regeln und Richtlinien zum Herunterladen und Verarbeiten von Produktfeeds.
Beispiel für eine Feed-URL mit Paginierung
Dieses Beispiel ruft einen Produkt-Feed mit 50 Produkten pro Seite ab:
https://daisycon.io/datafeed/?media_id=22848&standard_id=1&language_code=fr&locale_id=3&type=xml&program_id=21835&records=50&encoding=utf8
Beispiel für Antwort-Header
Die Antwort-Header für die obige Anfrage:
X-Total-Count: 80 X-Current-Count: 50 X-Next-Url: https://daisycon.io/datafeed/?media_id=22848&standard_id=1&language_code=fr&locale_id=3&type=xml&program_id=21835&records=50&encoding=utf8&search_after=%5B%229ddb817799f9e33217cc07a4d6ff295e%22%5D
Dieser Feed enthält 80 Produkte. Die erste Anfrage liefert 50 Produkte, die Anfrage an die X-Next-Url die restlichen 30. Diese letzte Antwort enthält keinen X-Next-Url-Header, also wurden alle Produkte abgerufen.