HTTP durum kodları
| Kod | Trendyol'daki anlamı | Ne yapmalı |
|---|---|---|
| 200, 201, 202, 204 | İstek işlendi, oluşturuldu, kabul edildi ya da içeriksiz kabul edildi | Toplu işlemse batch sonucunu kontrol edin |
| 400 | Zorunlu alan eksik ya da kabul edilmeyen değer | Gövdeyi dokümandaki alan adları ve tiplerle karşılaştırın |
| 401 | Kimlik bilgisi eksik ya da yanlış | API Key, API Secret ve satıcı ID'yi kontrol edin |
| 403 | Sunucu isteği reddetti; çoğunlukla hatalı uç nokta, parametre ya da eksik User-Agent | Yolu ve User-Agent başlığını kontrol edin |
| 404 | Kaynak yok ya da adres yanlış | Yolu ve kimlikleri (paket, iade, soru ID) doğrulayın |
| 405 | Yanlış HTTP yöntemi | GET, POST, PUT ya da DELETE seçimini düzeltin |
| 409 | Çakışma; kaynak beklenen durumda değil | Kaynağın durumunu okuyup tekrar deneyin |
| 414 / 415 | Adres çok uzun / desteklenmeyen gövde biçimi | Parametreleri azaltın; doğru Content-Type gönderin |
| 429 | İstek sınırı aşıldı | Bekleyip artan aralıklarla yeniden deneyin |
| 500, 502, 503, 504 | Trendyol tarafında hata, kesinti ya da zaman aşımı | Bekleyip deneyin; 504'te isteği küçük parçalara bölün |
Sık görülen hata mesajları
| Mesaj ya da anahtar | Nerede görülür | Çözüm |
|---|---|---|
| ClientApiAuthenticationException (401) | Tüm servisler | Kimlik bilgilerini yeniden kopyalayın; canlı ve test bilgilerini karıştırmayın |
| too.many.requests (429) | Tüm servisler | Aynı uç noktaya 10 saniyede 50'den fazla istek atmayın |
| 15 dakika boyunca aynı isteği tekrarlı olarak atamazsınız | Stok ve fiyat güncelleme | Yalnız değişen kalemleri gönderin |
| scheduled brownout (426) | Kapatılan eski uç noktalar | v2 uç noktalarına geçin |
| invalid.barcode / product.not.found | Arşivleme, kilit kaldırma | Barkod biçimini ve ürünün sistemde olduğunu kontrol edin |
| 409 fatura linki | Fatura linki gönderme | Pakete daha önce fatura beslenmiş ya da link başka pakete verilmiş |
| 400 cursor ile filtre uyumsuzluğu | Sipariş akış servisi | nextCursor kullanırken filtreleri değiştirmeyin |
| 503 test ortamında | Stage | Sunucu IP'sini yetkilendirin |
Hata gövdesini okumak
Ürün servislerinin hata gövdesi errors adlı bir dizidir. Her elemanda key, message ve errorCode alanları bulunur. Örneğin key: invalid.barcode, message: Barkod formatı geçersiz, errorCode: 400.
Bazı servisler düz metin ya da farklı biçimde gövde döndürebilir. Kodunuzda önce errors dizisini, yoksa message alanını, o da yoksa ham gövdeyi kaydedin. Sadece "Request failed with status code 400" yazan bir log sorunun nedenini göstermez.
Toplu işlemlerde (ürün yaratma, güncelleme, stok-fiyat, arşivleme, silme, kilit kaldırma) HTTP katmanı 200 döner. Kalem bazlı hatalar toplu işlem kontrolü yanıtındaki failureReasons alanında yazar.
Destek talebi açarken
Hata sürüyorsa Trendyol, Taleplerim sayfasından bildirim açmanızı ister. Talebe şunları ekleyin:
- Sorun yaşadığınız servisin tam adresi ve HTTP yöntemi,
- İstek gövdesi (API anahtarlarını çıkararak),
- Aldığınız yanıtın tamamı ve durum kodu,
- Entegratörseniz satıcının Entegrasyon Referans Kodu.
Sık sorulanlar
Trendyol API 403 hatası neden olur?
En sık nedenler eksik ya da hatalı User-Agent başlığı ve yanlış uç nokta veya parametredir. User-Agent'ı "SATICI_ID - SelfIntegration" biçiminde gönderin ve yolu dokümanla karşılaştırın.
200 aldım ama ürün yüklenmedi, neden?
Ürün ve stok-fiyat servisleri isteği kuyruğa alır ve yalnız batchRequestId döner. Kalem bazlı sonuç toplu işlem kontrolü servisinden okunur; hata nedeni failureReasons alanındadır.
426 hata kodu ne anlama gelir?
Trendyol kapatma takvimindeki eski uç noktalara belirli saatlerde 426 ve brownout mesajı döndürür. Bu, ilgili servisin v2 sürümüne geçmeniz gerektiği anlamına gelir.
500 hatasında ne yapmalıyım?
Birkaç dakika bekleyip tekrar deneyin. Sorun sürerse kullandığınız adres, istek ve yanıtla birlikte Taleplerim sayfasından API entegrasyon destek talebi açın.
Kaynaklar
İlgili Trendyol API konuları
Son güncelleme: 27.10.2026 · Trendyol API rehberinin tamamı