Trendyol Ürün V2 API’ye Genel Bakış
Trendyol Marketplace entegrasyonu için sunulan Ürün V2 API, satıcıların ürün yönetimini otomatize etmesini sağlar. API servisleri iki versiyon grubuna ayrılır: V1-V2 ortak ve yalnızca V2. V1-V2 ortak servisler hem eski hem yeni altyapıda çalışırken, yalnızca V2 olarak işaretlenenler yeni geliştirilmiş uçlardır. Bu sayede geliştiriciler, güncel ve performanslı endpoint’leri kullanarak entegrasyonlarını modernize edebilir.Aşağıdaki bölümlerde, temel veri servislerinden ürün yönetimine, özel işlemlerden filtreleme kontrollerine kadar tüm önemli endpoint’leri inceleyeceğiz.
Temel Veri Servisleri: Marka, Kategori ve Özellikler
Entegrasyonun ilk adımı, Trendyol’da geçerli olan marka, kategori ve özellik bilgilerini almaktır. Bu veriler ürün oluşturma ve güncelleme işlemlerinde temel teşkil eder.Marka Listesi (V1-V2)GET /integration/product/brands – Trendyol’da kayıtlı tüm markaları listeleyebilirsiniz.Kategori Listesi (V1-V2)GET /integration/product/product-categories – Ürün kategorilerini ve hiyerarşik yapıyı getirir.Kategori Özellik Listesi (V2)GET /integration/product/categories/{categoryId}/attributes – Seçilen kategoriye ait özellikleri (renk, beden vb.) döndürür.Kategori Özellik Değerleri (V2)GET /integration/product/categories/{categoryId}/attributes/{attributeId}/values – Bir özelliğe ait geçerli değerleri (örneğin “Kırmızı”, “Mavi”) almanızı sağlar.Bu servisler sayesinde ürünlerinizi doğru kategorilere ve özelliklere göre tanımlayabilirsiniz.
Ürün Yönetimi: Oluşturma, Güncelleme ve Silme
Ürün verilerini sisteme aktarmak ve mevcut kayıtları yönetmek için V2 API’de birçok endpoint bulunur. İşte en kritik işlemler:Ürün Yaratma (V2)POST /integration/product/sellers/{sellerId}/v2/products – Yeni bir ürün oluşturur. Tüm zorunlu alanlar (başlık, barkod, kategori, fiyat, stok) eksiksiz gönderilmelidir.Ürün Güncelleme (V2)Onay sürecine göre dört farklı güncelleme servisi bulunur:Onaysız Ürün Güncelleme: POST /.../products/unapproved-bulk-update – Henüz onaylanmamış ürünleri toplu günceller.Onaylı Ürün – İçerik: POST /.../products/content-bulk-update – Başlık, açıklama, görsel gibi içerik alanlarını değiştirir.Onaylı Ürün – Varyant: POST /.../products/variant-bulk-update – Varyant bazlı (renk/beden) güncellemeler yapar.Onaylı Ürün – Teslimat: POST /.../products/delivery-info-bulk-update – Kargo ve teslimat bilgilerini günceller.Stok ve Fiyat Güncelleme (V1-V2)POST /integration/inventory/sellers/{sellerId}/products/price-and-inventory – Hızlı stok/fiyat değişiklikleri için kullan
Filtreleme, Arşivleme ve Özel Servisler
Ürünlerinizi listeleme, filtreleme, arşivleme ve ek işlemler için V2 API’de ayrıca şu önemli endpoint’ler bulunur:Ürün Filtreleme (V2)Temel Bilgiler: GET /.../product/{barcode} – Barkod ile ürün detayını sorgular.Onaysız Ürünler: GET /.../products/unapproved – Henüz onaylanmamış ürünleri listeler.Onaylı Ürünler: GET /.../products/approved – Onaylanmış ürünleri getirir.Onaylı Ürün Stok ve Fiyat: GET /.../products/approved/inventory-and-price – Onaylı ürünlerin güncel stok ve fiyat bilgilerini döndürür.Ürün Arşivleme (V1-V2)PUT /.../products/archive-state – Ürünleri arşive almak veya arşivden çıkarmak için kullanılır.Özel ServislerBuybox Kontrol: POST /.../products/buybox-information – Ürünün buybox durumunu sorgular.Kilit Kaldırma: PUT /.../products/unlock – Düzenleme kilidini kaldırır.Video Oluşturma / Listeleme: POST /.../videos – Ürünlere video eklemek için kullanılır (V2).Marka Yaratma: POST /.../brands – Trendyol’da yeni marka kaydı oluşturur (V2).Toplu İşlem Kontrolü: GET /.../bat
Sonuç ve Öneriler
Trendyol Ürün V2 API, satıcılar için güçlü ve esnek bir entegrasyon altyapısı sunar. Servis kapsamında hangi endpoint’in hangi versiyona ait olduğunu kontrol ederek doğru uç noktaları kullanmanız önemlidir. V2’ye özel servisler (örneğin kategori özellik listesi, ürün yaratma v2, video servisi) daha yeni ve optimize edilmiştir. Bu rehberde yer alan tüm endpoint’leri test ortamınızda deneyerek sistemi tanımanızı öneririz. Başarılı entegrasyonlar dileriz!