Sipariş ve Paket Adedini Ayırt Edin
Trendyol entegrasyonunda sipariş numarası ile sevkiyat paketi kimliği farklı kayıtlardır. Aynı sipariş parçalanabilir; bazı değişikliklerde sipariş numarası korunurken yeni paket kimliği oluşabilir. Bu nedenle mağaza panelindeki sipariş adediyle API üzerinden alınan paket adedinin eşit olması her durumda beklenmez. İncelemede örnek siparişin bütün paketleri ve durumları birlikte ele alınmalıdır. Tek bir paket kaydını bulamamak, siparişin tamamının silindiğini göstermez. Sistemin eşleştirmeyi sipariş numarası mı yoksa paket kimliği üzerinden mi yaptığı da açıkça belirlenmelidir.
Toplam Sonuç Her Sayfaya Erişilebildiğini Göstermez
V2 sipariş paketleri servisinde erişilebilir kayıt penceresi 10.000 ile sınırlıdır. Yanıtta toplam sonuç veya sayfa sayısı daha yüksek görünse bile aynı geniş sorguyla bütün sayfalara ulaşılabileceği varsayılmamalıdır. Örneğin filtre on iki bin paketle eşleşiyorsa yalnızca ilk on bin kaydı almak bütün siparişlerin eşitlendiği anlamına gelmez. Kontrol, dönen toplamla gerçekten işlenen benzersiz paketleri karşılaştırmalıdır. Büyük veri taraması için stream servisi veya uygun biçimde daraltılmış sorgular değerlendirilir; sayfa numarasını sonsuza kadar artırmak çözüm değildir.
Stream Servisinde İlerleme Göstergesi Değişir
Stream servisinde ilk çağrı cursor olmadan yapılır. Yanıttaki hasMore devam edilecek veri bulunduğunu, nextCursor sonraki istekte kullanılacak işaretçiyi belirtir. Bu değer çözümlenmemeli veya elle değiştirilmemelidir. Aynı cursor kullanılırken başlangıç filtreleri de korunmalıdır; farklı filtre için yeni tarama başlatılır. Örneğin işlem yarıda kesilince sayfa numarası artıran eski kod kullanılıyorsa kayıtlar eksik kalabilir. Entegrasyonun yalnızca yeni servis adresine geçirilmesi yeterli değildir; ilerlemeyi ve tamamlanmayı belirleyen mantığın da yeni yapıya uygun olması gerekir.
Son Güncelleme Aralığını Sipariş Tarihi Sanmayın
Stream servisi son üç aylık veriye erişim sunar ve tek sorgunun son güncelleme aralığını en çok on dört günle sınırlar. Parametreler verilmediğinde kapsam son iki haftaya daralır. Bu aralık, siparişin ilk oluşturulduğu tarihle aynı kavram değildir. Örneğin daha önce oluşmuş bir paketin durumu sonradan değiştiğinde güncelleme takibinde yeniden görülmesi beklenebilir. Tarihleri yazdırırken kullanılan saat dilimi ve milisaniye biçimi de tutarlı olmalıdır. Takvimde seçilen gün ile API’ye gönderilen zaman sınırlarının farklı olması, gün başındaki veya sonundaki kayıtları kaçırabilir.
Tamamlanmayı Kaydedip Tekrarları Yönetin
Sağlıklı bir tarama kaydında başlangıç filtresi, son kullanılan cursor, işlenen benzersiz paket adedi ve bitiş sonucu tutulabilir. hasMore false olmadan süreç tamamlandı kabul edilmemelidir. Bir paket yeniden görüldüğünde aynı siparişin tekrar sevkiyata verilmesi gibi yan etkiler engellenmelidir. Örnek doğrulamada birden fazla paketli sipariş, güncellenen paket ve zaman aralığının sınırındaki kayıtlar seçilebilir. Sonuç sadece API hatası olmaması değildir; beklenen paketlerin alınması, güncel durumların işlenmesi ve işin nerede kaldığının gerektiğinde yeniden izlenebilmesidir.
Bu Yazıdaki Terimler 1 Kavram
Kısa açıklamaları burada okuyabilir, ayrıntılar için sözlüğe geçebilirsiniz.
- API
- API (Application Programming Interface), farklı yazılımların birbirleriyle veri alışverişi yapmasını sağlayan bağlantı yöntemidir.
Bu Konuda Nasıl Destek Oluyoruz?
AdPix’in bu alandaki hizmet kapsamını ve çalışma sürecini inceleyin.
Trendyol