Adım adım: bilgiler nerede?
Trendyol, entegrasyon için gereken üç değeri tek bir ekranda toplar. Aşağıdaki adımlar resmî dokümandaki menü yolunu izler. Menü adları zamanla değişebilir; değişirse panelin arama kutusunda "Entegrasyon Bilgileri" yazmanız yeterlidir.
| Adım | Ne yapılır |
|---|---|
| 1 | partner.trendyol.com adresinden satıcı paneline master kullanıcıyla giriş yapın. |
| 2 | Sağ üstte mağaza adınıza tıklayın. |
| 3 | Açılan menüden Hesap Bilgilerim sayfasını seçin. |
| 4 | Entegrasyon Bilgileri sekmesine geçin. |
| 5 | Satıcı ID, API Key ve API Secret değerlerini kopyalayın. |
Ekran görüntülü anlatım için Trendyol API bilgileri nasıl alınır? rehberine bakabilirsiniz. Yazılım tarafında bu bilgilerin nasıl kullanıldığı kimlik doğrulama sayfasında anlatılır.
Her bilgi ne işe yarar?
Dokümanda aynı değer için farklı adlar geçer. Satıcı ID, supplierId ve sellerId aynı numaradır. Karışıklığı önlemek için hangi değerin isteğin neresine gittiğini bilin.
| Bilgi | Dokümandaki adı | İstekte nerede kullanılır |
|---|---|---|
| Satıcı ID | supplierId, sellerId | Adres yolundaki {sellerId} kısmı ve User-Agent başlığının başı |
| API Key | API KEY | Basic Auth kullanıcı adı |
| API Secret | API SECRET KEY | Basic Auth şifresi |
| Entegrasyon Referans Kodu | Entegrasyon Referans Kodu | Trendyol entegrasyon desteğinden yardım isterken |
Entegrasyon Referans Kodu API çağrılarında kullanılmaz. Trendyol, entegratörünüzün ya da yazılım ekibinizin destek alırken bu kodu vermesini ister. Doküman bu kodu da API anahtarı kadar gizli tutmanızı söyler.
Kopyalarken dikkat edilecekler
- Değerleri başında ve sonunda boşluk kalmadan kopyalayın. Görünmeyen bir boşluk bile kimlik doğrulamayı bozar.
- API Key ile API Secret alanlarını karıştırmayın. Basic Auth'ta sıra önemlidir: önce key, sonra secret.
- Canlı ve test bilgilerini ayrı tutun. Test ortamı hesabı ve anahtarları canlıdan tamamen farklıdır.
- Alt kullanıcılar bu sayfayı göremez. Bilgileri mağazanın ana hesabıyla alın.
- Anahtarları GitHub, GitLab gibi açık platformlara, ekran görüntülerine ya da e-postaya koymayın.
Sık hatalar ve çözümleri
| Belirti | Olası neden | Çözüm |
|---|---|---|
| 401 ve ClientApiAuthenticationException | API Key, API Secret ya da satıcı ID yanlış | Üç değeri yeniden kopyalayın; key ve secret sırasını kontrol edin. |
| 403 Forbidden | User-Agent başlığı eksik ya da hatalı | Başlığı "SATICI_ID - SelfIntegration" biçiminde gönderin. |
| Entegrasyon Bilgileri sekmesi görünmüyor | Admin rolü olmayan kullanıcıyla giriş | Ana kullanıcıyla giriş yapın. |
| Test ortamında 503 | Sunucu IP'niz test ortamı için yetkilendirilmemiş | IP yetkilendirmesi talep edin. |
| Canlıda çalışan bilgi testte 401 veriyor | Canlı bilgiler test ortamında geçmez | Stage panelindeki Hesap Bilgilerim'den test anahtarlarını alın. |
Bilgileri doğru girdiğiniz hâlde hata sürüyorsa önce tek ve basit bir okuma isteği deneyin. Örneğin kategori listesini çekmek, sorunun anahtarda mı yoksa isteğin gövdesinde mi olduğunu ayırır.
Sık sorulanlar
Trendyol API bilgilerini neden göremiyorum?
Entegrasyon Bilgileri sayfası yalnız master kullanıcı (admin rolü) ile giriş yapıldığında görünür. Alt kullanıcı hesabıyla girdiyseniz mağazanın ana hesabıyla tekrar giriş yapın.
Satıcı ID, supplierId ve sellerId aynı şey mi?
Evet. Trendyol dokümanında üç ad da aynı satıcı numarasını anlatır. Bu numara adres yolundaki {sellerId} alanına ve User-Agent başlığının başına yazılır.
Test ortamında canlı API bilgilerimi kullanabilir miyim?
Hayır. Test ortamı hesap ve API bilgileri canlıdan tamamen farklıdır. Test anahtarları stagepartner.trendyol.com panelindeki Hesap Bilgilerim bölümünden alınır.
Entegrasyon Referans Kodu API isteğinde kullanılır mı?
Hayır. Bu kod Trendyol entegrasyon desteğinden yardım alırken kimlik doğrulama için istenir. API anahtarı gibi gizli tutulmalı ve yalnız yetkili kişilerle paylaşılmalıdır.
Kaynaklar
İlgili Trendyol API konuları
Son güncelleme: 27.10.2026 · Trendyol API rehberinin tamamı