Toplu güncelleme kuralı
| Kural | Değer | Kaynak |
|---|---|---|
| Toplu stok ya da fiyat isteği aralığı | Satıcı başına yaklaşık 10 saniye | Canlı entegrasyon |
| İstek başına kalem | En fazla 3.000 | Canlı entegrasyon |
| Başarılı yanıt | 200: istek kabul edildi, işlem sıraya alındı | Canlı entegrasyon |
Bu değerler Pazarama'nın resmî dokümanında bu rehber için doğrulanamadı; canlıda çalışan bir entegrasyonun uyduğu kurallardır. Güncel sınırı İş Ortağım panelindeki entegrasyon dokümanından kontrol edin. 200 yanıtı değişikliğin vitrine yansıdığı anlamına gelmez; işlem sırayla yapılır ve birkaç dakika sürebilir.
HTTP durumları
| Durum | Ne zaman | Ne yapmalı |
|---|---|---|
| 200 ve success=false | İstek ulaştı ama işlem reddedildi | message alanını okuyun, veriyi düzeltin |
| 400 ya da 401 (token isteğinde) | Key ya da Secret hatalı veya süresi dolmuş | Panelden bilgileri kontrol edin |
| 401 (API isteğinde) | Token süresi dolmuş ya da geçersiz | Token'ı yenileyip bir kez tekrarlayın |
| 404 | Yol yanlış | Yolu kontrol edin; v2 yolu yoksa eski yola bakın |
| 429 | İstek sınırı aşıldı | Retry-After kadar bekleyin |
| 503 | Servis geçici olarak hizmet dışı | Birkaç saniye sonra yeniden deneyin |
429 ve Retry-After'ın genel anlamı MDN 429 ve MDN Retry-After sayfalarında anlatılır.
Hata mesajı nerede?
Pazarama hata gövdeleri farklı biçimlerde gelebilir. Canlı entegrasyon mesajı şu sırayla arar:
- message: Pazarama sarmalının açıklama alanı.
- error_description ve error: OAuth2 kimlik sunucusunun standart hata alanları.
- errors: birden çok doğrulama hatası içeren dizi; her öğenin message alanı.
- Hiçbiri yoksa ham gövde metni.
error ve error_description, RFC 6749'da token hataları için tanımlanan alanlardır; token isteğinde aldığınız hatayı bu alanlardan okursunuz. Servis hatalarında ise genelde message ya da errors doludur.
Yeniden deneme düzeni
- 429'da Retry-After'a uyun; başlık yoksa en az birkaç saniye bekleyin.
- Toplu istekleri bir kuyruğa koyup sırayla gönderin; aynı mağaza için paralel göndermeyin.
- 3.000 kalemden büyük listeleri parçalayın ve parçalar arasında aralık bırakın.
- 503 ve ağ kopmalarında artan aralıklarla birkaç kez deneyin.
- Kalıcı hatada (400, success=false) yeniden denemeyin; önce veriyi düzeltin.
- Her hatayı ham gövdesiyle kaydedin; Pazarama'ya destek talebi açarken bu kayıt gerekir.
Stok tutarlılığının genel mantığı için pazaryeri stok senkronu rehberine bakabilirsiniz.
Sık sorulanlar
Pazarama API'de istek sınırı var mı?
Canlı entegrasyon toplu stok ve fiyat isteklerini satıcı başına yaklaşık 10 saniyede bir gönderir. Sınır aşılırsa 429 döner; güncel kuralı entegrasyon dokümanından kontrol edin.
Bir stok isteğinde kaç ürün gönderilir?
Canlı entegrasyon istek başına en fazla 3.000 kalem gönderir. Daha büyük listeler parçalara bölünür.
200 aldım ama değişiklik görünmüyor, neden?
Stok ve fiyat servisleri eşzamansızdır; 200 yalnız isteğin kabul edildiğini gösterir. Değişiklik birkaç dakika içinde yansır. Gövdede success=false varsa istek reddedilmiştir.
success=false ne demek?
İstek Pazarama'ya ulaştı ama işlem yapılmadı. Nedeni message alanında yazar; veriyi düzeltmeden yeniden göndermeyin.
Kaynaklar
İlgili Pazarama API konuları
Son güncelleme: 27.10.2026 · Pazarama API rehberinin tamamı