WooCommerce-API-Paginierung: So legen Sie die Ergebnisse pro Seite im Jahr 2026 fest
17. August 2026
Meistern Sie die WooCommerce-API-Paginierung pro Seite im Jahr 2026. Lernen Sie den per_page-Parameter, Limits und Best Practices für E-Commerce-Entwickler in Großbritannien kennen.
WooCommerce API-Paginierungsparameter verstehen
Bei der Arbeit mit der WooCommerce-REST-API ist Paginierung für die Verwaltung großer Datenmengen unerlässlich. Die API verwendet zwei Hauptparameter: `page` und `per_page`. `per_page` steuert, wie viele Ergebnisse in einer einzelnen Anfrage zurückgegeben werden, während `page` bestimmt, welche Teilmenge Sie abrufen. Für Entwickler im Vereinigten Königreich ist dies besonders wichtig, wenn Sie mit umfangreichen Produktkatalogen, Kundenlisten oder Bestellverläufen arbeiten. Standardmäßig gibt WooCommerce 10 Elemente pro Seite zurück, Sie können dies jedoch auf maximal 100 erhöhen. Der Parameter `per_page` wird in der Anfrage-URL festgelegt, zum Beispiel: `/wp-json/wc/v3/products?per_page=50`. Das Verständnis, wie diese Parameter mit Antwort-Headern wie `X-WP-Total` und `X-WP-TotalPages` interagieren, ist der Schlüssel zur Entwicklung effizienter Integrationen.
Festlegen des Seitenlimits: Was UK-Entwickler wissen müssen
Für britische E-Commerce-Websites wirkt sich die Wahl des richtigen `per_page`-Werts sowohl auf die Leistung als auch auf die Serverlast aus. Ein höherer Wert bedeutet weniger Anfragen, was den Overhead reduziert und ideal für Massenvorgänge ist, etwa zum Synchronisieren von Produkten mit einem POS-System oder einer digitalen Marketingplattform. Ein zu hoher Wert kann jedoch die Antwortzeiten verlangsamen und den Speicherverbrauch Ihres Hostings erhöhen, insbesondere wenn Sie Shared Hosting von britischen Anbietern wie 123 Reg oder Fasthosts nutzen. Die API erzwingt eine strikte Obergrenze von 100 pro Anfrage. Um darüber hinauszugehen, müssen Sie Paginierung verwenden oder einen benutzerdefinierten Filter-Hook implementieren, aber das Standardmaximum liegt bei 100. Wir empfehlen, für die meisten britischen E-Commerce-Arbeitsabläufe mit `per_page=50` zu starten, um Geschwindigkeit und Zuverlässigkeit in Einklang zu bringen.
Praktische Beispiele: Abrufen von Produkten mit benutzerdefinierten Pro-Seite-Werten
Gehen wir ein typisches Szenario für einen britischen Online-Bekleidungshändler durch. Angenommen, Sie müssen alle Produkte in der Kategorie 'hoodies' abrufen. Ihre Anfrage könnte so aussehen: `GET /wp-json/wc/v3/products?category=123&per_page=100&page=1`. Wenn die Gesamtzahl der Hoodies 250 beträgt, erhalten Sie 100 auf der ersten Seite, 100 auf der zweiten und 50 auf der dritten. Um alle Seiten zu durchlaufen, können Sie den Header `X-WP-TotalPages` auslesen und entsprechend eine Schleife ausführen. In PHP mit dem offiziellen WooCommerce-Client würden Sie `$woocommerce->get('products', ['per_page' => 100, 'page' => 2])` verwenden. Denken Sie immer daran, Ihren Consumer-Key und Ihr Secret zur Authentifizierung anzugeben. Dieser Ansatz hält Ihre Integration sauber und vermeidet das Erreichen der Rate-Limits, die von Ihrem Server oder einem in Großbritannien ansässigen API-Gateway festgelegt werden.
Umgang mit Paginierung für britische E-Commerce-Websites mit hohem Datenvolumen
UK-E-Commerce-Websites, insbesondere solche, die über mehrere Kanäle wie Amazon oder eBay verkaufen, haben oft Tausende von Produkten. Die Paginierung wird zu einem Leistungsengpass, wenn sie nicht korrekt verwaltet wird. Eine empfohlene Strategie besteht darin, Daten in kleineren Stapeln mit `per_page=100` abzurufen und jede Seite synchron zu verarbeiten, wobei die Ergebnisse in einer lokalen Datenbank oder Warteschlange gespeichert werden. Beispielsweise muss ein britisches Dropshipping-Unternehmen möglicherweise Preise häufig aktualisieren; die Verwendung von Paginierung mit `per_page=50` und das Caching von Antworten können eine Serverüberlastung verhindern. Ziehen Sie außerdem in Betracht, die Parameter `orderby` und `order` zu verwenden, um eine konsistente Reihenfolge über paginierte Anfragen hinweg beizubehalten, was für inkrementelle Aktualisierungen entscheidend ist. Viele britische Entwickler verwenden auch Hintergrundjobs (z. B. WP-Cron oder externe Worker), um paginierte API-Aufrufe zu verarbeiten und sicherzustellen, dass keine einzelne Anfrage eine Zeitüberschreitung verursacht oder übermäßige Ressourcen verbraucht.
Häufige Fallstricke und Best Practices für die WooCommerce-API-Paginierung
Ein häufiger Fehler, den UK-Entwickler machen, ist die Annahme, dass `per_page` beliebig hoch gesetzt werden kann. Denken Sie daran: Die WooCommerce REST API begrenzt den Wert standardmäßig auf 100 – er kann jedoch durch die PHP-Einstellungen Ihres Hosting-Anbieters oder durch Plugins weiter gesenkt werden. Eine weitere Falle besteht darin, den Link-Header zu ignorieren, der Paginierungs-Metadaten wie `next`- und `prev`-URLs enthält. Die bewährte Praxis ist, diese Header für die Seitennavigation zu nutzen, anstatt URLs manuell zu konstruieren. Achten Sie außerdem auf Timeouts: Das Abrufen einer Seite mit 100 großen Produktobjekten kann auf langsameren britischen Shared-Hosting-Servern mehr als 30 Sekunden dauern. Setzen Sie in Ihrem API-Client stets ein angemessenes Timeout und erwägen Sie die Verwendung des `_fields`-Parameters, um nur die tatsächlich benötigten Daten anzufragen. Respektieren Sie schließlich die Ratenbegrenzungen Ihres Servers – wenn Sie viele paginierte Anfragen stellen, verteilen Sie diese zeitlich, um 429-Fehler zu vermeiden.
FAQ
Der Standardwert für `per_page` in der WooCommerce REST API ist 10. Das bedeutet, dass ohne Angabe eines `per_page`-Parameters in Ihrer Anfrage nur die ersten 10 Elemente (z. B. Produkte, Bestellungen, Kunden) zurückgegeben werden. Um mehr zu erhalten, können Sie `per_page` in der URL Ihrer API-Anfrage auf einen beliebigen Wert zwischen 1 und 100 festlegen.