İstek yapısı
Gövde products adlı bir liste içerir. Çalışan entegrasyonun gönderdiği alanlar şunlardır:
| Alan | Kaynak |
|---|---|
| stockCode | Güncellenecek ürünün stok kodu |
| productName | Ürünün mevcut adı |
| mainProductCode | Mevcut ana ürün kodu |
| categoryId | Mevcut kategori |
| salesPrice, listPrice | Mevcut fiyatlar |
| stockQuantity | Mevcut stok |
| images | Yeni görsel listesi; her biri imageIndex ve url |
imageIndex 1'den başlar ve görsel sırasını belirler. İlk görsel ürünün ana görselidir.
Neden bütün alanlar gönderiliyor?
Bu entegrasyonun kod notuna göre v1 ürün servisi görsel güncellemesini desteklemiyor; görsel değişikliği v2 servisinden yapılıyor ve istek zorunlu alanları da istiyor. Bu yüzden önce ürünün güncel verisi ürün listesinden okunur, sonra aynı değerler yeni görsellerle birlikte gönderilir.
Bunun önemli bir sonucu var: güncel olmayan bir önbellekten okunan fiyat ya da stok, görsel güncellemesiyle birlikte geri yazılabilir. Görsel güncellemesini, stok ve fiyatın sık değiştiği saatlerin dışında yapın ve okuma ile yazma arasındaki süreyi kısa tutun.
Görsel kuralları ve hız
Ürün yüklemedeki görsel kuralları güncellemede de geçerlidir:
- En az 1, en fazla 5 aktif görsel kullanın.
- Aynı bağlantıyı iki kez göndermeyin.
- Çok büyük görseller (2.048 piksel ve üzeri) reddedildi; 2.000 pikseli aşmayan sürümleri tercih edin.
- Bağlantılar herkese açık olmalı; Çiçeksepeti görseli kendi sunucusundan indirebilmelidir.
Görsel güncellemeleri tek tek gönderilir. Bu entegrasyonda istekler arasında saniyede bir hız korunuyor; toplu bir görsel yenilemesi yüzlerce ürün için dakikalar sürebilir.
Sık hatalar
- Ürün bulunamadı: Stok kodu Çiçeksepeti ürün listesinde yoksa güncelleme yapılamaz. Önce ürünün onaylanıp listede göründüğünden emin olun.
- Eski veriyle yazmak: Ürün listesini çok eski bir önbellekten okumak fiyat ya da stoğu geri alabilir.
- Onay bekleyen üründe güncelleme: İncelemedeki ürün listede görünmediği için güncellemenin dayanacağı veri de yoktur. Onayı bekleyin.
- Virgülle birleşik görsel metni: Görselleri tek metin olarak değil, imageIndex ve url alanlı nesneler olarak gönderin.
- Aynı istekte stok değiştirmek: Stok ve fiyat için price-and-stock servisini kullanın; görsel isteğinde mevcut değerleri koruyun.
Sık sorulanlar
Çiçeksepeti ürün görseli API ile nasıl değiştirilir?
Çalışan bir entegrasyonda PUT /api/v2/Products isteğiyle. Görseller imageIndex ve url alanlarıyla, ürünün stok kodu, adı, kodları, kategorisi, fiyatları ve stoğuyla birlikte gönderilir.
Görsel güncellerken fiyatı da göndermem gerekir mi?
Bu entegrasyonda istek ürünün mevcut fiyat ve stoğunu da içeriyor. Değerleri güncel ürün listesinden okuyup aynen gönderin; değiştirmek istiyorsanız price-and-stock servisini kullanın.
Kaç görsel gönderebilirim?
Canlıda alınan hatalara göre en az 1, en fazla 5 aktif görsel. Görsel bağlantıları tekrarlanmamalı ve görseller çok büyük olmamalıdır.
Görsel güncellemesi neden yavaş ilerliyor?
Her ürün için ayrı istek gider ve istekler arasında yaklaşık bir saniye beklenir. Ayrıca ürün listesinin önce okunması gerekir. Yüzlerce ürünlük bir görsel yenilemesi bu yüzden dakikalar sürebilir.
Kaynaklar
İlgili Çiçeksepeti API konuları
Son güncelleme: 27.10.2026 · Çiçeksepeti API rehberinin tamamı