Kimlik doğrulama
Trendyol API, Basic Authentication ile çalışır. Kullanıcı adı API Key, şifre API Secret'tır. Üç bilgi de satıcı panelinde Hesap Bilgilerim > Entegrasyon Bilgileri sayfasındadır ve yalnız admin rolündeki ana kullanıcıya görünür.
Her istekte User-Agent başlığı zorunludur. Kendi yazılımınızda "SATICI_ID - SelfIntegration", entegratör kullanıyorsanız "SATICI_ID - FirmaAdi" yazılır. Ayrıntılar: API bilgilerini alma ve kimlik doğrulama.
Ortamlar ve temel adres
| Ortam | Temel adres | Erişim |
|---|---|---|
| Canlı | https://apigw.trendyol.com | IP yetkilendirmesi gerekmez |
| Test (stage) | https://stageapigw.trendyol.com | Sunucu IP'niz yetkilendirilmeli; ayrı hesap ve ayrı API bilgileri |
Servis yolları çoğunlukla /integration ile başlar. Örneğin stok ve fiyat güncelleme /integration/inventory/sellers/{sellerId}/products/price-and-inventory adresindedir. Finans servisleri /integration/finance/che, webhook servisleri /integration/webhook altında durur. Trendyol 2025'te temel adresi değiştirdi; eski adreslere yapılan istekler hata alır.
İstek sınırları
Genel kural: aynı uç noktaya 10 saniye içinde en fazla 50 istek atılabilir. 51. istek 429 too.many.requests hatası alır. Bunun üzerine servis bazlı dakika limitleri vardır ve çoğu satıcının ürün listeleme limitine göre kademelenir.
14 Eylül 2026'dan beri ürün limitleri tek tek servise değil üç gruba uygulanır: Product Integration Read, Product Integration Write ve Inventory & Price Write. En düşük kademede bu gruplar dakikada sırasıyla 1000, 200 ve 350 istektir. Tam tablo istek sınırları sayfasındadır.
Sürümler
Trendyol 2026'da ürün servislerini barkod bazlı yapıdan içerik (content) bazlı v2 yapısına taşıdı. Eski ürün servisleri 15 Eylül 2026'ya kadar desteklendi. Sipariş paketlerini çekme servisinde /v2/orders yolu 15 Ekim 2026'dan beri zorunludur.
Geçiş tablosu ve alan farkları sürümler ve v2 geçişi sayfasındadır. Güncel duyurular için Trendyol'un changelog sayfasını izleyin.
Genel hata kodları
| Kod | Anlamı |
|---|---|
| 400 | Zorunlu alan eksik ya da kabul edilmeyen değer var |
| 401 | Kimlik bilgisi eksik veya yanlış (ClientApiAuthenticationException) |
| 403 | User-Agent eksik ya da hatalı uç nokta veya parametre |
| 404 | Kaynak bulunamadı ya da adres yanlış |
| 409 | Çakışma; örneğin pakete daha önce fatura linki gönderilmiş |
| 429 | İstek sınırı aşıldı |
| 500, 502, 503, 504 | Trendyol tarafında geçici sorun; bekleyip yeniden deneyin |
Toplu işlemlerde 200 yanıtı yalnız isteğin kuyruğa alındığını gösterir. Gerçek sonuç batchRequestId ile toplu işlem kontrolü servisinden okunur. Tüm kodlar ve özel mesajlar hata kodları sayfasında.
Trendyol API işlemleri
Genel
Ürün ve katalog
Stok ve fiyat
Sipariş
İade
Soru-cevap
Finans
Webhook
Sık sorulanlar
Trendyol test ortamına nasıl erişilir?
Test ortamı https://stageapigw.trendyol.com adresindedir ve sunucu IP'nizin yetkilendirilmesini ister. Test hesabı ve API bilgileri canlıdan ayrıdır; talep satıcı paneli üzerinden bildirim açılarak yapılır.
Trendyol API'nin temel adresi nedir?
Canlı ortamın temel adresi https://apigw.trendyol.com, test ortamınınki https://stageapigw.trendyol.com adresidir. Servis yolları bu adreslerin ardından /integration ile başlar.
Trendyol API dokümanı nerede?
Resmî doküman developers.trendyol.com adresindedir. Kılavuz sayfaları ve API referansı ayrı bölümlerdedir; değişiklikler changelog sayfasında duyurulur.
Trendyol kod desteği veriyor mu?
Hayır. Trendyol sıkça sorulan sorular sayfasında kod desteği sağlamadığını belirtir. Entegrasyon sorunları için Taleplerim sayfasından servis adresi, istek gövdesi ve aldığınız hatayla birlikte bildirim açılır.
Trendyol API ile hangi işlemler yapılabilir?
Ürün yaratma ve güncelleme, stok ve fiyat güncelleme, sipariş paketlerini çekme ve statü bildirme, kargo etiketi, fatura linki, iade onayı ve ret talebi, müşteri sorularını cevaplama, cari hesap ekstresi ve sipariş webhook'ları yapılabilir.