Giriş

Duyurular !

1 Haziran 2021 itibari ile TLS 1.2 altı versiyon kullanıyorsanız, yeni protokol kısıtına göre revize işlemlerini yapmanız gerekmektedir. Aksi takdirde Trendyol API Servislerine erişemeyeceksiniz .

Yeni muhasebe servisimiz yayındadır. İncelemek için muhasebe entegrasyonu bölümüne göz atabilirsiniz.

9 Nisan 2021 itibariyle Hızlı Market Entegrasyonu için sipariş ve iade servislerinde endpoint değişikliği olacaktır. Bu süreye kadar varolan endpointe ek olarak yeni endpointimiz de kullanılabilir olacaktır. Eski/yeni endpointleri "Hızlı Market Sipariş Entegrasyonu" ve Hızlı Market İade Entegrasyonu sayfalarından inceleyebilirsiniz. 9 Nisan 2021 itibariyle eski endpoint geçersiz olacaktır. Buna göre sisteminizi düzenlemenizi rica ederiz.

1 Şubat 2021 itibari ile getShipmentPackages servislerine yapılacak istek parametrelerine limitlendirme getirilecektir. Sayfanın aşağısında yer alan "Trendyol API Servis İstek Sınırlaması" bölümünde detayları inceleyebilirsiniz.

Trendyol API Entegrasyonu Nedir & Ne İşe Yarar ?

Trendyol API Entegrasyonu, Trendyol Partner Programı’na (Marketplace) katılan firmaların Trendyol API servisleri aracılığıyla Trendyol mağazalarını kendi e-ticaret sistemlerine bağlayarak ürün aktarımı, stok ve fiyat güncellemesi, sipariş işlemleri, fatura gönderimi ,müşteri soruları işlemleri gibi bir çok işlemi yapmasına olanak sağlar.

API Bağlantısının Kurulması (Authorization)

Authorization için basic auth kullanılacaktır.

Canlı ortamda kullanacağınız basic auth için gerekli API kullanıcı bilgilerinize satıcı paneliniz üzerinde yer alan “Hesap Bilgilerim” menüsü içerisindeki “Entegrasyon Bilgileri” başlığından ulaşabilirsiniz.

1 Ocak 2021 itibari ile Trendyol Partner API ‘ye yapılacak bütün isteklerde Header'da Auth ve User-Agent bilgilerinin bulunması zorunludur.

User-Agent bilgisi olarak aracı bir firma ile çalışılıyor ise "Satıcı Id - {Entegrasyon Firması İsmi}" , entegrasyon yazılımı firmaya ait ise "Satıcı Id - SelfIntegration" gönderilmelidir.

Örnek 1 :

  • SatıcıId : 1234
  • Entegratör firma ismi : TrendyolSoft
  • Gönderilecek user-agent bilgisi : "1234 - TrendyolSoft"

Örnek 2 :

  • SatıcıId : 4321
  • Entegratör firma yok. Yazılım firmaya ait.
  • Gönderilecek user-agent bilgisi : "4321 - SelfIntegration"

NOT: Entegratör firma isminizi alfanumerik karakterler ile maksimum 30 hane olacak şekilde gönderiniz.

User-Agent bilgisi gönderilmeyen istekler 403 hatası dönecek şekilde blocklanacaktır.

Trendyol API Servis İstek Sınırlaması

Trendyol Partner API'ye yapacağınız tüm isteklerde aynı endpointe 10 saniye içerisinde maksimum 50 request atabilirsiniz. 51. requesti denediğiniz an sizlere "429 status code and it say too.many.requests" hatası dönecektir.

1 Şubat 2021 itibari ile API entegrasyon getOrders servislerine yapılacak isteklerde "size" parametresine verilebilecek maksimum değer : 50 , "page" parametresine verilebilecek maksimum değer : 10000 olarak sınırlandırılacaktır. "size" ve "page" limitini aşan isteklere status:400 hatası dönecektir.

CANLI ORTAM BİLGİLERİ

Canlı ortamda herhangi bir IP yetkilendirmesine gerek bulunmamaktadır.

Satıcı ID ve API Key bilgilerinize Trendyol Satıcı Paneli üzerinden sağ üstte bulunan Mağaza Adınıza > Hesap Bilgilerim menüsüne tıklayarak ulaşabilirsiniz.

Canlı ortam endpoint bilgisi :

https://api.trendyol.com/sapigw/

NOT : İnternet servis sağlayıcınız Yurtdışında ise Timeout hatası aldığınız zaman Partner Destek ekranından bildirim açarak bizlere ulaşmanız gerekmektedir.

TEST ORTAMI BİLGİLERİ

Test ortamı hesap ve API bilgileriniz canlı ortam bilgilerinizden tamamen farklıdır.

1. Adım : Test ortamına erişebilmek için uygulama sunucularının IP bilgileri Trendyol tarafına bildirilerek erişim tanımı yapılmalıdır. Birden fazla IP tanımı yapılabilir, tanımlanan IP ler daha sonra bildirilmesi halinde güncellenebilir.

NOT : Test ortamı talebi ve IP yetkilendirmesi işlemleri için Partner Destek ekranında yer alan "Entegrasyon Sürecini Kendi Yazılım Ekibim İle Yöneteceğim" başlığından bildirim açmanız geremektedir.

NOT : Test ortamında alacağınız 503 hatası IP yetkilendirmesi olmamasından kaynaklıdır.

2. Adım (IP yetkilendirmesi gerektirmektedir) : Test ortamı için ortak test hesabını kullanabilir veya buradan kendi test mağazanızı oluşturabilirsiniz.

Ortak test hesabı bilgileri için Partner Destek ekranında yer alan "Entegrasyon Sürecini Kendi Yazılım Ekibim İle Yöneteceğim" başlığından bildirim açmanız geremektedir.

API bilgilerinize stage partner sayfasınızda her alan "Hesap Bilgilerim" bölümünden ulaşabilirsiniz.

3. Adım (IP yetkilendirmesi gerektirmektedir): Testlerinizi test mağaza API bilgileri ile kendi yazılımınız üzerinden veya POSTMAN aracılığı ile örnek collection kullanarak yapabilirsiniz.

Örnek Collection : https://www.getpostman.com/collections/f9b539a8c0473552e56e

Collection dosyasını Postman > Import > Link yolu ile ekleyebilirsiniz.

Stage Trendyol Paneli: https://stagepartner.trendyol.com/account/login

Test ortamı endpoint bilgisi : https://stageapi.trendyol.com/stagesapigw/