Servislere göre sayfalama parametreleri
| Uç | Parametreler | İlk sayfa | Yanıttaki sayfa bilgisi |
|---|---|---|---|
| Listing listeleri | offset, limit | offset=0 | totalCount, limit, offset |
| MPOP mağaza ürünleri | page, size | page=0 | totalElements, totalPages, last |
| MPOP kategoriler | page, size, leaf, available | page=0 | last |
| OMS paketlenecek siparişler | offset, limit, begindate, enddate | offset=0 | totalCount, pageCount |
| OMS paket durum listeleri | offset, limit | offset=0 | totalCount |
MPOP sayfa numaraları sıfırdan başlar. Sayfa 1'den başlayan bir döngü ilk sayfayı atlar ve ürünlerin bir kısmı hiç okunmaz.
Son sayfayı doğru anlamak
En sık yapılan hata, son sayfayı istenen boyutla karşılaştırarak bulmaktır. MPOP mağaza ürün listesinde size 100 ile sınırlıdır. Daha büyük bir değer isteseniz de sunucu en fazla 100 kayıt döner. "Gelen kayıt istenen boyuttan az, demek ki son sayfa" mantığı bu yüzden ilk sayfada döngüyü keser.
- MPOP'ta yanıttaki last alanına bakın; last true ise durun.
- last alanı yoksa gelen kayıt sayısını sunucunun gerçek üst sınırıyla (100) karşılaştırın.
- Listing'de offset değerini her turda limit kadar artırın; boş ya da limitten kısa sayfa gelince durun.
- Kategori listesi binlerce yaprak kategori içerir. Canlı kullanımda sayfa başına 2000 kayda kadar istenebildi.
Tarih filtresi olmayan uçlar
Paketlenecek sipariş listesi begindate ve enddate alır. Ama kargodaki, teslim edilen ve teslim edilemeyen paket listeleri yalnız offset ile limit alır; tarih filtresi yoktur. Eski ayların siparişlerine ulaşmak için bu listeleri tükenene kadar sayfa sayfa gezmek gerekir.
Sınırsız döngü kurmayın. Bir güvenlik sınırı koyun ve hangi sayfada durduğunuzu kaydedin. Aksi hâlde yoğun bir mağazada tek bir okuma yüzlerce istek üretir.
İstek sınırına takılmamak
Hepsiburada'nın güncel istek sınırları için geliştirici portalını kontrol edin; burada sayı vermiyoruz. Genel HTTP kuralına göre 429 yanıtı kısa sürede çok fazla istek gönderildiğini anlatır ve Retry-After başlığı ne kadar bekleneceğini söyleyebilir (MDN: 429).
- Stok ve fiyatı tek tek değil, liste hâlinde gönderin. Stok ve envanter yükleme uçları dizi kabul eder.
- Aynı SKU'yu aynı pakete iki kez koymayın; paket reddedilir ve yeniden deneme gereksiz yük üretir.
- Ürün yükleme gibi ağır isteklerin arasına kısa bekleme koyun.
- Hata alınca hemen yeniden denemeyin; bekleme süresini her denemede artırın.
Sık hatalar ve çözümleri
| Belirti | Olası neden | Çözüm |
|---|---|---|
| Yalnız ilk 100 ürün geliyor | Döngü, istenen boyuttan az kayıt gelince kesiliyor | MPOP'ta last alanına bakın |
| İlk sayfadaki ürünler eksik | MPOP döngüsü page=1'den başlıyor | page=0'dan başlayın |
| Eski siparişler görünmüyor | Paket listeleri tarih filtresi sanılıp tek sayfa okunmuş | Listeleri sayfa sayfa gezin |
| Ara ara reddedilen istekler | Bekleme olmadan art arda istek | İstekleri seyreltin, artan bekleme kullanın |
Sık sorulanlar
Hepsiburada API istek sınırı nedir?
Güncel sınırlar resmî dokümanda yayımlanır. Sınıra takılmamak için toplu uçları kullanın ve istekler arasına bekleme koyun.
MPOP ürün listesinde sayfa başına kaç kayıt alabilirim?
En fazla 100. Daha büyük bir size isteseniz de sunucu 100 kayıt döner; son sayfayı last alanından anlayın.
Kargodaki siparişleri tarihe göre filtreleyebilir miyim?
Paket durum listeleri yalnız offset ve limit alır. Tarih filtresi paketlenecek sipariş listesinde vardır.
Sayfa numarası 0'dan mı 1'den mi başlar?
MPOP'ta 0'dan başlar. Listing ve OMS'de sayfa numarası yerine offset kullanılır ve ilk değer 0'dır.
Kaynaklar
İlgili Hepsiburada API konuları
Son güncelleme: 27.10.2026 · Hepsiburada API rehberinin tamamı