Asenkron batch modelinin mantığı
Trendyol Batch API, büyük hacimli stok ve fiyat güncellemelerini senkron bekletmek yerine kuyruğa alır. İstek gönderdiğinizde hemen batchRequestId döner; işlemin tamamlanıp tamamlanmadığını ayrı bir sorgu ile öğrenirsiniz.
Bu model rate limit'i korur ancak operasyon zihniyetini değiştirir: «istek attım = bitti» düşüncesi yanlıştır. Her batch için durum makinesi tasarlayın: PENDING → PROCESSING → COMPLETED / PARTIAL / FAILED.
Payload yapısı ve boyut limitleri
Batch payload'ında her satır bir SKU/varyant güncellemesidir. Tek istekte çok fazla satır göndermek timeout riskini artırır; optimal batch boyutunu kendi ortamınızda benchmark ile bulun (genelde 100–500 satır arası).
Aynı barcode'u aynı batch içinde iki kez göndermek undefined behavior üretebilir. Gönderim öncesi deduplication uygulayın; son değer kazanır mantığı her zaman geçerli olmayabilir.
- Batch öncesi JSON schema validasyonu çalıştırın
- Büyük batch'leri saat dilimine yayın — kampanya başlangıcında kuyruk şişer
- Her batch'e anlamlı correlation ID ekleyin (ör. nightly-stock-2026-03-01)
Sonuç sorgulama ve partial failure
batchRequestId ile sonuç endpoint'ini polling yaparak sorgulayın. Polling aralığı agresif olursa rate limit yer; 30–60 saniye başlangıç için makul. Webhook desteği varsa polling'i yedek mekanizma olarak tutun.
PARTIAL durumda başarısız satırları extract edip küçük bir retry batch'i oluşturun. Tüm batch'i tekrar göndermek gereksiz yük ve duplicate işlem riski taşır.
İç kuyruk tasarımı ve önceliklendirme
Uygulama katmanında batch kuyruğu kurun: acil (sipariş sonrası stok düşümü), normal (gece senkronu), düşük (fiyat optimizasyonu). Öncelik olmadan FIFO kuyruk, kritik stok güncellemesinin saatlerce beklemesine yol açar.
Dead letter queue (DLQ) tanımlayın: 3 deneme sonrası başarısız batch'ler DLQ'ya düşsün ve operasyon ekibine günlük özet rapor gitsin.
Gözlemlenebilirlik ve SLA
Batch işleme süresini p50, p95 metrikleriyle izleyin. Kampanya öncesi p95 iki katına çıkıyorsa kapasite planı yapın. batchRequestId'yi structured log'a yazın; destek ticket'ında ilk istenen bilgi budur.
Batch başarı oranını SKU kategorisi kırılımında raporlayın. Belirli kategoride sürekli failure varsa katalog eşleştirme sorunu, genel düşüşte API veya ağ sorunu araştırın.
Sık sorulan sorular
Batch ne kadar sürede tamamlanır?
Yük ve döneme göre değişir; birkaç saniye ile 15 dakika arası normal kabul edilir. Sürekli 30 dakikayı aşan gecikme için Trendyol destek ve kendi payload boyutunuzu inceleyin.
Aynı anda kaç batch gönderebilirim?
Rate limit dokümantasyonuna bağlıdır; paralel batch sayısını kademeli artırarak test edin. Agresif paralellik 429 hatası ve kuyruk tıkanıklığı üretir.
Batch ID'yi ne kadar saklamalıyım?
En az 30 gün; dispute ve audit için 90 gün önerilir. Sonuç JSON'unu sıkıştırılmış arşivde tutmak disk maliyetini düşük tutar.
Senkron endpoint yerine batch ne zaman tercih edilir?
10+ SKU güncellemesi, gece toplu senkron ve kampanya öncesi kitlesel fiyat değişiminde. Tekil acil düzeltmeler için senkron veya küçük batch yeterlidir.
Pillar rehber
Trendyol satıcıları için entegrasyon yalnızca «ürün çekmek» değildir. Güvenli credential yönetimi, batch push sonuçları, katalog eşleştirme ve sync izleme birlikte çalışmalıdır.
Trendyol entegrasyonu: API'den operasyona
