Parametreler
| Parametre | Açıklama |
|---|---|
| lastModifiedStartDate / lastModifiedEndDate | Paketin son değişiklik zamanına göre aralık, milisaniye; en fazla 14 gün |
| packageItemStatuses | Statü filtresi; birden çok statü virgülle ayrılır |
| size | Bir istekte dönecek paket sayısı; varsayılan 50, en fazla 200 |
| nextCursor | Önceki yanıttan gelen imleç; ilk istekte gönderilmez |
Tarih gönderilmezse sistem aralığı otomatik olarak son iki haftayla sınırlar. Filtre, paketin oluşturulma tarihine değil son değişiklik tarihine bakar. Bu nedenle eski bir sipariş, statüsü yakın zamanda değiştiyse yeni pencerede görünür.
İmleçle sayfalama nasıl çalışır?
- İlk istekte nextCursor göndermeyin.
- Yanıtta hasMore true ise nextCursor değerini alın ve bir sonraki isteğe ekleyin.
- hasMore false olduğunda akış biter.
- nextCursor opak bir değerdir; ayrıştırmayın, değiştirmeyin, saklayıp olduğu gibi gönderin.
- Aynı imleçle devam ederken filtreleri değiştirmeyin. Filtre değişirse 400 Bad Request alırsınız.
- Yeni bir filtreyle çalışmak için yeni bir akış başlatın.
Trendyol istekler arasında en az 5 saniye bırakmanızı önerir. Sipariş servis limiti en düşük kademede dakikada 30 istek olduğu için bu aralık limit aşımını da önler.
v2 servisi ile karşılaştırma
| Özellik | v2/orders | orders/stream |
|---|---|---|
| Kullanım amacı | Küçük ve anlık sorgular | Büyük veri taraması ve senkronizasyon |
| Sayfalama | page ve totalPages | nextCursor ve hasMore |
| Erişilebilir kayıt | Filtre başına 10.000 | Yüksek limitli akış |
| Tarih filtresi | startDate, endDate | lastModifiedStartDate, lastModifiedEndDate |
| Veri kapsamı | Son 1 aya sınırlanacağı duyuruldu | Son 3 ay |
| Sıralama | Seçilebilir | Sabit: son değişiklik, yeniden eskiye |
Örnek: 3 aylık tam tarama
Üç aylık sipariş geçmişini almak için dönemi 14 günlük pencerelere bölün; bu yaklaşık yedi pencere eder. Her pencerede nextCursor ile akışı sonuna kadar okuyun, sonra bir önceki pencereye geçin.
Aynı paket farklı pencerelerde tekrar görünebilir, çünkü filtre son değişiklik tarihine bakar. Paketleri shipmentPackageId ile tekilleştirin ve her paketin en son hâlini saklayın. Taramayı yarıda keserseniz son başarılı pencereden yeni bir akışla devam edin; eski imleçleri yeniden kullanmaya çalışmayın.
Akış servisi yeni siparişi anında bildirmez. Gerçek zamana yakın takip için webhook kurun, akışı eksik kalan olayları kapatmak için düzenli bir yedek tarama olarak kullanın.
Sık sorulanlar
getShipmentPackagesStream ne zaman kullanılmalı?
Tüm siparişleri taramak, periyodik senkron yapmak ya da dışa aktarmak için. Küçük ve anlık sorgularda v2/orders yeterlidir.
Akış servisi kaç aylık sipariş verir?
Son 3 aylık veriye erişilir. Tek bir istekteki zaman aralığı en fazla 14 gündür; tarih verilmezse son iki hafta kabul edilir.
nextCursor ile birlikte filtre değiştirebilir miyim?
Hayır. Aynı imleçle devam ederken filtre değişirse 400 hatası döner. Yeni filtre için akışı baştan başlatın.
Akış yanıtında toplam kayıt sayısı var mı?
Hayır. totalElements, totalPages ve page alanları dönmez. Devam edip etmeyeceğinizi hasMore alanı gösterir.
v2/orders'tan akış servisine geçerken kodda ne değişir?
page++ yerine yanıttaki nextCursor gönderilir, totalPages kontrolü yerine hasMore okunur ve tarih parametreleri lastModifiedStartDate ile lastModifiedEndDate olur. Paket yanıtının yapısı aynı kalır.
Kaynaklar
İlgili Trendyol API konuları
Son güncelleme: 27.10.2026 · Trendyol API rehberinin tamamı