Trendyol API Entegrasyonu: API Key, Kimlik Doğrulama ve Test Ortamı
Özet
Trendyol API (Partner API), satıcıların ürün, stok-fiyat, sipariş ve iade işlemlerini kendi yazılımlarından yönetmesini sağlar. API bilgileri satıcı panelinde Hesap Bilgilerim → Entegrasyon Bilgileri sayfasındadır: satıcı ID (supplierId), API Key ve API Secret. İstekler Basic kimlik doğrulamayla yapılır ve her istekte "SatıcıID - SelfIntegration" biçiminde User-Agent başlığı bulunmalıdır; başlık yoksa istek 403 ile reddedilir, yanlış bilgi 401 döner. Test için ayrı bir stage ortamı vardır: hesap ve API bilgileri canlıdan tamamen farklıdır, IP adresinin Trendyol'a bildirilmesi gerekir ve erişim Partner Destek üzerinden talep edilir.
Trendyol API Entegrasyonu Nasıl Yapılır?
- 1
API bilgilerini alın
Satıcı panelinde Hesap Bilgilerim → Entegrasyon Bilgileri'nden satıcı ID, API Key ve API Secret'ı alın ve sunucu ortam değişkenlerinde saklayın.
- 2
Stage erişimi isteyin
Partner Destek üzerinden stage ortamı talep edin, IP adresinizi bildirin ve size verilen ayrı test bilgileriyle çalışın.
- 3
Kimlik doğrulamayı kurun
Basic auth ve "SatıcıID - SelfIntegration" User-Agent başlığıyla ilk isteği atıp 200 yanıtı aldığınızı doğrulayın.
- 4
Ürün, stok ve sipariş akışını bağlayın
Ürün eşleştirmesini yapın, stok/fiyat güncellemesini sipariş anında tetikleyin, siparişleri periyodik çekip durumlarını güncelleyin.
- 5
Canlıya geçin
Stage'de tüm senaryolar geçtikten sonra canlı bilgilere geçin ve ilk günlerde güncelleme sonuçlarını yakından izleyin.
Trendyol API Nedir, Ne İşe Yarar?
Trendyol Partner API, satıcı panelinde elle yaptığınız işlemleri yazılımla yapmanızı sağlar. En yaygın kullanım, Trendyol'u kendi e-ticaret sitenizle veya stok sisteminizle aynı stok havuzuna bağlamaktır: bir kanalda satılan ürün diğerinde de düşer, siparişler tek yerde toplanır.
- Ürün aktarımı ve güncelleme
- Stok ve fiyat güncelleme
- Siparişleri çekme ve sipariş durumu güncelleme
- İade ve müşteri soruları gibi satış sonrası işlemler
Trendyol API Key Nasıl Alınır?
API bilgileri satıcı panelinde Hesap Bilgilerim → Entegrasyon Bilgileri sayfasında yer alır. Burada satıcı ID'niz (supplierId), API Key ve API Secret bulunur. API Key her satıcı ID'sine özgüdür; bu bilgiler yalnızca sunucu tarafında saklanmalı, tarayıcıya veya istemci koduna konmamalıdır.
Kimlik Doğrulama ve Zorunlu Başlıklar
İstekler Basic kimlik doğrulamayla (API Key ve Secret) yapılır. Bunun yanında her istekte User-Agent başlığı zorunludur: kendi yazılımınızla entegre oluyorsanız değer "SatıcıID - SelfIntegration" biçimindedir (örneğin "12345 - SelfIntegration"). Bu başlık olmadan gönderilen istekler 403 ile engellenir; kimlik bilgileri yanlışsa 401 döner.
Stage (Test) Ortamı
Trendyol'un canlıdan ayrı bir stage test ortamı vardır. Stage'deki hesap ve API bilgileri canlıdakilerden tamamen farklıdır; canlı bilgilerle stage'e, stage bilgileriyle canlıya istek atılamaz. Stage'i kullanmak için IP adresinizin Trendyol'a bildirilmesi gerekir ve erişim, Partner Destek ekranında entegrasyonu kendi yazılım ekibinizle yöneteceğinizi belirten talep üzerinden alınır. Canlı ortamda IP yetkilendirmesi gerekmez.
Sık Yapılan Hatalar
Trendyol entegrasyonlarında sorunların çoğu birkaç tekrar eden hatadan kaynaklanır.
- User-Agent başlığını göndermemek → 403
- Stage ve canlı kimlik bilgilerini karıştırmak → 401
- API bilgilerini istemci tarafı koda koymak (güvenlik açığı)
- Stok güncellemesini sipariş anında değil, seyrek toplu işlerle yapmak → aynı ürünün iki kanalda satılması
- Ürün/stok gönderiminin sonucunu kontrol etmemek → sessizce reddedilen güncellemeler
Trendyol'u Hepsiburada, n11 ve kendi sitenizle tek panelde birleştirmek isterseniz: Pazaryeri entegrasyonu
Sık Sorulan Sorular
Trendyol API kullanmak ücretli mi?
API bilgileri satıcı panelinde satıcıya verilir; erişim koşullarını ve güncel kuralları Trendyol satıcı panelinden ve geliştirici dokümanından teyit edin. Entegrasyonun geliştirilmesi ayrı bir iştir.
Trendyol API 403 hatası neden alınır?
En sık sebep User-Agent başlığının eksik olmasıdır. Kendi yazılımınızla entegre oluyorsanız her istekte "SatıcıID - SelfIntegration" biçiminde User-Agent gönderilmelidir.
Trendyol API 401 hatası neden alınır?
Kimlik bilgileri hatalıdır ya da ortamla eşleşmiyordur. Stage ve canlı ortamın API bilgileri farklıdır; stage bilgisiyle canlıya (veya tersi) istek atıldığında 401 döner.
Hazır entegratör mü, kendi Trendyol entegrasyonumuz mu?
Standart ürün ve stok akışı için hazır entegratörler hızlı başlangıç sağlar. Kanal bazlı fiyat kuralları, kendi sitenizle ortak stok, ERP bağlantısı veya özel raporlama gerekiyorsa API üzerinden kendi entegrasyonunuz daha esnektir ve size ait olur.
Solman Digital
Bu rehber, gerçekleştirilen projelerden derlenen doğrudan deneyime dayanmaktadır. Konuya ilişkin sorularınız için doğrudan uzman erişimi sunuyoruz.
Trendyol entegrasyonu: sabit kapsam, ₺9.900'den
Ücretsiz Araçlar
Rakamları Kendiniz Hesaplayın
Entegrasyon veya geliştirme kararı vermeden önce SolmanAI'nin ücretsiz hesaplama araçlarıyla mevcut durumunuzu analiz edebilirsiniz.