Trendyol API nedir, nasıl kullanılır? Satıcılar için rehber

Trendyol API ne işe yarar, hangi servis grupları var?

Trendyol’un resmî tanımıyla API; ürün aktarımı, stok ve fiyat güncellemesi, sipariş işlemleri, fatura gönderimi ve müşteri soruları gibi işlemlerin satıcının kendi yazılımından yapılmasını sağlar. Satıcı Bilgi Merkezi entegrasyonla yapılabilecek işlemleri şöyle sıralar: ürün, sipariş, ortak etiket, iade, soru-cevap, webhook, muhasebe ve finans entegrasyonları. Geliştirici dokümanı aynı grupları tazmin, satıcı bilgileri, fatura, e-faturam ve sağlık kontrolü servisleriyle genişletir.

Yazma servisleri kuyrukla işlenir: her başarılı istek bir toplu işlem numarası (batchRequestId) döndürür; sonuç toplu işlem sorgusuyla ürün bazında kontrol edilir ve 4 saat boyunca görüntülenebilir. Yani “istek 200 döndü” demek “ürün güncellendi” demek değildir; sonuç ayrıca okunur.

API anahtarı nereden alınır, nasıl yönetilir?

Basic Authentication için gereken satıcı numarası, API Key ve API Secret, Satıcı Paneli’nde Hesap Bilgilerim bölümündeki Entegrasyon Bilgileri sayfasından alınır; bu bilgiler yalnız ana kullanıcı (admin rolü) ile giriş yapıldığında görünür. Trendyol, anahtarların GitHub ya da GitLab gibi açık platformlarda paylaşılmaması konusunda uyarır. Birincil anahtar silinemez; sızdığından şüphelenirseniz “API Bilgilerini Güncelle” ile yenilenir ve eski bilgilerle yapılan istekler hata alır.

Aynı sayfada “Pazaryeri entegratörü ile çalışıyor musunuz?” sorusu bulunur. Entegratör Firma Ekle ile birden fazla entegratör tanımlanabilir; her eklemede hangi servislerin açılacağı (ürün, satıcı bilgileri, sipariş, fatura, iade, webhook, teslimat, soru-cevap, muhasebe ve finans) seçilir ve üretilen anahtar yalnız seçilen servislerde çalışır. Kendi yazılımıyla çalışan satıcı entegratör adına “Self Integration” yazar.

1. Satıcı Paneli’ne ana kullanıcıyla giriş yapın; Hesap Bilgilerim > Entegrasyon Bilgileri sayfasını açın.
2. Entegratörle çalışacaksanız firmayı ekleyin ve servis kapsamını seçin; kendi yazılımınızla çalışacaksanız “Self Integration” yazın.
3. Satıcı numarası, API Key ve API Secret bilgilerini yalnız sunucu tarafında, şifreli saklayın.
4. Sızıntı şüphesinde “API Bilgilerini Güncelle” ile anahtarı yenileyin.

İstek kuralları ve hız sınırları

Her istekte kimlik bilgisi ve User-Agent başlığı zorunludur; User-Agent olmayan istekler 403 ile engellenir. Başlık biçimi “Satıcı Id - Entegrasyon Firması İsmi” ya da “Satıcı Id - SelfIntegration” şeklindedir; firma adı alfanümerik ve en çok 30 karakterdir. Genel sınır aynı uç noktaya 10 saniyede en çok 50 istektir; 51. istek 429 (too.many.requests) alır.

14 Eylül 2026’dan itibaren ürün servisleri tek tek uç nokta bazında değil grup bazında sınırlanır. Sınır, satıcının ürün listeleme seviyesine göre değişir (seviye Ürün Listesi sayfasında görünür). Ayrıca fiyat güncellemesinde barkod bazlı dakikada 30 istek sınırı vardır. Aşağıdaki tablo geliştirici dokümanındaki değerleri aktarır.

V1’den V2’ye geçiş

Uç nokta tablosunda “V1-V2” yazan servisler iki sürümde ortaktır; yalnız “V2” yazanlar yeni geliştirilen servislerdir. Stok-fiyat güncelleme, silme, arşivleme, buybox ve kilit kaldırma ortaktır; ürün yaratma (/v2/products), onaylı ve onaysız ürün güncelleme, filtreleme ve güncelleme denetimi yalnız V2’dedir.

Kapanış tarihi için iki resmî metin uyuşmuyor: geliştirici sitesinin ana sayfası “V1 servisleri 15 Ekim 2026 itibarıyla kullanıma kapatılacaktır” derken Satıcı Bilgi Merkezi’ndeki entegrasyon SSS’si “Ürün Entegrasyonu V1 servisleri Ağustos 2026 itibarıyla kullanım dışı olacaktır” der. İki tarih de resmî kaynakta geçtiği için burada ikisi birden verilir; güvenli yol, programınızın bugün V2 kullandığından emin olmaktır. Aynı ana sayfada Order V2 servisinin de duyurulduğu yazılıdır.

Entegratörle mi, kendi yazılımınızla mı?

Satıcı Bilgi Merkezi, bünyesinde yazılım ekibi bulunmayan satıcılar için entegratör firmaların bu hizmeti sağladığını yazar ve seçim yaparken şu soruları önerir: ürün yükleme ve güncelleme, stok-fiyat, sipariş, fatura, iade, farklı platformlar için stok yönetimi, muhasebe ve mutabakat. Kendi yazılımınızı yazacaksanız yukarıdaki hız sınırlarını, toplu işlem sonucu okumayı ve V2 geçişini istemcinize siz yazarsınız; entegratörle çalışıyorsanız bunları onun yaptığını ve anahtarınızın yalnız gereken servislere açık olduğunu doğrulayın.

Test ortamı var mı?

Evet. Test uç noktası stageapigw.trendyol.com adresidir; test ortamına erişim için IP yetkilendirmesi gerekir, canlı ortamda ise IP yetkilendirmesine gerek yoktur. Test hesabı ve API bilgileri canlı bilgilerden tamamen farklıdır; IP bildirimi ve ortak test hesabı için satıcı destek hattı üzerinden bildirim yapılır. Test ortamında alınan 503 hatası IP yetkisinin olmamasından kaynaklanır.

IP izin listesi servisi yalnız IPv4 kabul eder; en çok 7 IP tanımlanabilir ve günde en fazla 7 IP oluşturulabilir; kayıtlara bir son kullanma zamanı üretilir.

Sık karşılaşılan hatalar

Resmî açıklamalara göre: 400 zorunlu alan eksik ya da kabul edilmeyen değer; 401 kimlik bilgisi yok ya da yanlış; 403 hatalı uç nokta/parametre ya da User-Agent eksik; 429 hız sınırı aşımı; 500 ve 502 Trendyol tarafı, yeniden deneyin; 503 kesinti (test ortamında IP yetkisi yok); 504 isteği bölün; 556 yanlış uç nokta ya da servis parametresi. “Ürünümü entegrasyonla yükledim ama satışta değil” durumunda toplu işlem sonucu 4 saat içinde kontrol edilir: approved alanı onayı, onSale alanı satışta olmayı gösterir.

Webhook kullanıyorsanız: başarısız istek her 5 dakikada bir tekrarlanır, sürerse webhook pasife alınır; iletim “en az bir kez” ilkesiyle çalışır, bu yüzden uç noktanız aynı olayı iki kez alabileceğini varsaymalıdır; en çok 15 webhook tanımlanabilir.

Yekuna ile Trendyol API’si nasıl kullanılır?

Yekuna’da Entegrasyonlar bölümünden Trendyol’u seçin, Entegrasyon Bilgileri sayfasındaki bilgileri girin ve bağlantıyı test edin; bilgiler şifrelenerek saklanır. Kanaldan gelen teknik hata kodları sadeleştirilir; ne olduğu ve ne yapmanız gerektiği yazılır. Fiyat ve stok gönderimi siz açıkça etkinleştirene kadar çalışmaz; kurulum boyunca Yekuna kanaldan yalnızca okur.

Sık sorulanlar

Trendyol API ücretli mi?

Resmî sayfalarda ücret bilgisi yer almıyor. Anahtar Satıcı Paneli’nden alınır; entegratörle çalışıyorsanız ücret entegratörün kendi fiyatlandırmasıdır.

API Key’i kim görebilir?

Yalnız ana kullanıcı (admin rolü) ile giriş yapıldığında görünür.

Dakikada kaç istek atabilirim?

Aynı uç noktaya 10 saniyede en çok 50 istek. Ürün servislerinde 14 Eylül 2026’dan itibaren grup bazlı dakikada 200–2.000 istek, satıcı seviyesine göre.

V1 ile devam edebilir miyim?

Geliştirici sitesinin ana sayfası V1 servislerinin 15 Ekim 2026’da kapatılacağını, Satıcı Bilgi Merkezi ise Ağustos 2026’yı yazıyor. Her iki durumda da V2’ye geçmeniz gerekir.

Test ortamı var mı?

Evet; stageapigw.trendyol.com. IP yetkilendirmesi ve ayrı test hesabı gerekir.

İlgili sayfalar