Zorunlu ve yaygın başlıklar
Aşağıdaki tablo bir isteğin başlıklarını özetler. Değerler örnektir; SATICI_ID, API_KEY ve API_SECRET yerine kendi bilgilerinizi koyun.
| Başlık | Örnek değer | Ne zaman gerekir |
|---|---|---|
| Authorization | Basic + base64(API_KEY:API_SECRET) | Her istekte zorunlu |
| User-Agent | SATICI_ID - SelfIntegration | Her istekte zorunlu; yoksa 403 |
| Content-Type | application/json | JSON gövdeli POST ve PUT isteklerinde |
| storeFrontCode | TR | Bazı servislerde; adres, kargo sağlayıcı ve güncelleme sonucu servislerinde gönderilmezse TR kabul edilir |
Marka yaratma, fatura dosyası yükleme ve iade ret talebi gibi dosya içeren isteklerde gövde JSON değil form-data olur. Bu isteklerde Content-Type başlığını HTTP kütüphanenizin üretmesine bırakın.
Basic Auth başlığı nasıl kurulur?
Basic Auth, kullanıcı adı ile şifrenin iki nokta üst üste ile birleştirilip base64 ile kodlanmasıdır. Trendyol'da kullanıcı adı API Key, şifre API Secret'tır. Satıcı ID bu başlığa girmez; adres yoluna ve User-Agent'a yazılır.
- API Key ile API Secret'ı aralarına iki nokta koyarak birleştirin: API_KEY:API_SECRET.
- Bu metni base64 ile kodlayın.
- Başlığı "Authorization: Basic KODLANMIS_METIN" olarak ekleyin.
- Postman kullanıyorsanız Authorization sekmesinde Basic Auth seçin; Username alanına API Key, Password alanına API Secret yazın.
User-Agent nasıl yazılır?
Trendyol, isteği kimin gönderdiğini User-Agent başlığından anlar. Kural basittir: başta satıcı ID, ardından tire ve entegrasyonu yapan tarafın adı gelir.
| Durum | User-Agent biçimi | Örnek |
|---|---|---|
| Yazılımı satıcı kendisi geliştirdi | Satıcı ID - SelfIntegration | 1234 - SelfIntegration |
| Bir entegratör firma ile çalışılıyor | Satıcı ID - Entegratör Adı | 1234 - FirmaAdi |
Entegratör adı yalnız harf ve rakamlardan oluşmalı ve en fazla 30 karakter olmalıdır. Türkçe karakter, boşluk ve noktalama içeren uzun adlar yerine kısa bir firma kodu kullanın.
Sık hatalar ve çözümleri
| Hata | Neden | Çözüm |
|---|---|---|
| 401 ClientApiAuthenticationException | Key, secret ya da satıcı ID yanlış; canlı ve test bilgileri karışmış | Bilgileri panelden yeniden kopyalayın; ortamla eşleştiğini kontrol edin. |
| 403 Forbidden | User-Agent yok ya da hatalı biçimde | Başlığı satıcı ID ile başlatın; entegratör adını 30 karakterle sınırlayın. |
| 403, adres doğru görünüyor | Hatalı uç nokta ya da parametre | Dokümandaki yolu harf harf karşılaştırın; v2 yollarını kullanın. |
| 429 too.many.requests | Aynı uç noktaya 10 saniyede 50'den fazla istek | İstekleri yayın ve istek sınırları sayfasındaki kurallara uyun. |
Kimlik doğrulama sorunlarını ayıklarken önce kategori listesi gibi satıcıya bağlı olmayan bir okuma isteği deneyin. Ardından satıcı ID içeren bir istekle devam edin. Böylece sorunun anahtarda mı yoksa satıcı ID'de mi olduğunu ayırırsınız.
Sık sorulanlar
Trendyol API hangi kimlik doğrulama yöntemini kullanır?
Basic Authentication kullanır. Kullanıcı adı API Key, şifre API Secret olur. OAuth ya da token alma adımı yoktur; her istekte aynı başlık gönderilir.
User-Agent göndermezsem ne olur?
Trendyol dokümanına göre User-Agent bilgisi olmayan istekler 403 hatası alarak engellenir. Başlık her istekte bulunmalıdır.
Entegratör firma adını User-Agent'a nasıl yazmalıyım?
Satıcı ID, boşluk, tire, boşluk ve firma adı sırasıyla yazılır. Firma adı alfanümerik olmalı ve en fazla 30 karakter uzunluğunda olmalıdır.
Satıcı ID Basic Auth başlığına eklenir mi?
Hayır. Basic Auth yalnız API Key ve API Secret ile kurulur. Satıcı ID adres yolundaki {sellerId} kısmında ve User-Agent başlığında kullanılır.
Kaynaklar
İlgili Trendyol API konuları
Son güncelleme: 27.10.2026 · Trendyol API rehberinin tamamı