Eski ve yeni uç noktalar
| İşlem | Eski (V1) | Yeni (V2) |
|---|---|---|
| Ürün aktarma | POST /integration/product/sellers/{sellerId}/products | POST /integration/product/sellers/{sellerId}/v2/products |
| Ürün güncelleme | PUT /integration/product/sellers/{sellerId}/products | POST .../products/unapproved-bulk-update, content-bulk-update, variant-bulk-update, delivery-info-bulk-update |
| Ürün filtreleme | GET /integration/product/sellers/{sellerId}/products | GET .../products/approved, .../products/unapproved, .../product/{barcode}, .../products/approved/inventory-and-price |
| Kategori özellikleri | GET /integration/product/product-categories/{categoryId}/attributes | GET /integration/product/categories/{categoryId}/attributes ve .../attributes/{attributeId}/values |
| Sipariş paketleri | GET /integration/order/sellers/{sellerId}/orders | GET /integration/order/sellers/{sellerId}/v2/orders ya da .../orders/stream |
Marka listesi, kategori ağacı, stok-fiyat güncelleme, ürün silme, arşivleme, buybox ve kilit kaldırma servisleri iki sürümde ortaktır.
Ürün v2: değişen alanlar
- Özellik yapısı değişti. V1'de attributeValueId ve customAttributeValue kullanılırdı; v2'de attributeValueIds (dizi) ve attributeValue (metin) kullanılır.
- Kategori özellik değerleri artık ayrı bir servisten, sayfalı olarak gelir.
- V1'deki sayısal cargoCompanyId yerine v2'de barkod bazlı kargo için cargoProviders alanına kargo sağlayıcı kodu yazılır.
- Onaylı ürün listesi content bazlı döner: her içeriğin altında variants dizisi vardır ve her varyant bir barkoddur.
- Onaylı ürünlerde içerik, varyant ve teslimat bilgisi ayrı servislerle güncellenir.
Sipariş v2: değişen kurallar
- /v2/orders ile filtre başına en fazla 10.000 paket kimliğine (maxQueryWindowResult) erişilir.
- Tek istekte en fazla 200 paket döner; güvenli sayfa aralığı page=0 ile page=49'dur.
- Doküman erişilebilir veri kapsamının son 1 ayla sınırlanacağını belirtir.
- Büyük veri taraması ve periyodik senkron için Trendyol imleç (cursor) tabanlı akış servisini önerir.
Geçiş döneminde eski /orders yoluna günde üç kez, 10'ar dakika boyunca 426 hata kodu döndürüldü. Bu hatayı alan bir entegrasyon, siparişleri o süre boyunca göremez ve stok düşümünü geciktirir.
Diğer yapısal değişiklikler
Sürüm geçişleri yalnız yol değişikliği değildir. Son iki yılda entegrasyonu etkileyen başka büyük değişiklikler de oldu:
- 2025'te temel adres değişti. Ürün, sipariş, ortak etiket, iade, soru-cevap, muhasebe ve webhook servisleri https://apigw.trendyol.com altına taşındı; eski servisler Mayıs 2025 sonundan itibaren kapatıldı.
- Aynı geçişte iade onay ve ret uç noktalarının yoluna satıcı ID eklendi.
- 14 Eylül 2026'da ürün servis limitleri servis bazlı yapıdan grup bazlı yapıya geçti.
- 8 Ekim 2026'da iade ret sebepleri listesi güncellendi; bazı sebep kodları pasife alındı, yenileri eklendi.
Geçiş kontrol listesi
| Kontrol | Neden |
|---|---|
| Kodda /v2/ içermeyen ürün aktarma ve filtreleme çağrısı kaldı mı? | Eski ürün servisleri 15 Eylül 2026 sonrası desteklenmiyor |
| Sipariş çekme /v2/orders ya da /orders/stream kullanıyor mu? | Eski /orders yolu 15 Ekim 2026'dan beri kullanım dışı |
| Özellikler attributeValueIds / attributeValue ile mi gönderiliyor? | V2 şeması farklı alan adları bekler |
| Yanıt okuyucu content > variants yapısını işliyor mu? | Onaylı ürün listesi iç içe döner |
| 426 ve brownout mesajı loglanıp alarm üretiyor mu? | Kapatma öncesi uyarıyı kaçırmamak için |
| Changelog düzenli izleniyor mu? | Tarihler duyurularla değişebiliyor; ürün v2 kapanışı önce 10 Ağustos, sonra 15 Eylül 2026 olarak duyuruldu |
Sık sorulanlar
Trendyol V1 ürün servisleri kapandı mı?
Trendyol changelog'una göre eski ürün servisleri 15 Eylül 2026 tarihine kadar desteklendi. Bu tarihten önce eski servislere günde üç kez brownout hatası döndürüldü. Yeni entegrasyonlar v2 servislerini kullanmalıdır.
Sipariş çekmede hangi uç nokta kullanılmalı?
15 Ekim 2026'dan beri GET /integration/order/sellers/{sellerId}/v2/orders zorunludur. Büyük veri taraması için cursor tabanlı /orders/stream servisi önerilir.
V2'de attribute alanları nasıl gönderilir?
Her özellik için attributeId ile birlikte liste değerlerinde attributeValueIds dizisi, serbest metin özelliklerde attributeValue gönderilir. Çoklu değer yalnız allowMultipleAttributeValues true olan özelliklerde kullanılabilir.
Brownout mesajı ne demek?
Kapatılacak bir uç noktanın planlı olarak kısa sürelerle devre dışı bırakılmasıdır. Trendyol bu dönemde "scheduled brownout" mesajıyla geçiş yapmanızı hatırlatır.
Kaynaklar
İlgili Trendyol API konuları
Son güncelleme: 27.10.2026 · Trendyol API rehberinin tamamı