İstek alanları
Çalışan bir entegrasyonun gönderdiği alanlar şunlardır:
| Alan | Açıklama |
|---|---|
| productName | Ürün adı |
| mainProductCode | Ana ürün (model) kodu; seçenekleri gruplar |
| stockCode | Seçeneğin benzersiz stok kodu; stok ve fiyat bununla güncellenir |
| categoryId | En alt kategori |
| description | Ürün açıklaması |
| deliveryType | Teslimat tipi kodu |
| deliveryMessageType | Teslimat mesajı tipi kodu |
| stockQuantity | Stok adedi |
| salesPrice | Satış fiyatı |
| listPrice | Liste (üstü çizili) fiyatı |
| barcode | Barkod |
| images | Görsel bağlantıları listesi |
| Attributes | Özellikler: Id, ValueId, TextLength |
deliveryType ve deliveryMessageType alanlarının alabileceği değerlerin anlamını Çiçeksepeti'nin size ilettiği dokümandan doğrulayın. Bu rehberde değer tablosu vermiyoruz.
Görsel ve kod kuralları
Canlıda alınan hatalardan çıkan kurallar şunlardır:
- Görsel sayısı: En az 1, en fazla 5 aktif görsel (hata kodu 1030). Altı ve üzeri görsel gönderilen ürünler toplu olarak reddedildi.
- Görsel boyutu: 2.048 piksel ve üzeri görseller "Görsel boyutu uygun değildir" ile reddedildi; 1.600 ve 1.800 piksellik görseller geçti.
- Tekrar eden bağlantı: Aynı görsel bağlantısı iki kez gönderilemez.
- Kod karakterleri: Model kodu ve barkod yalnız Latin harfleri ve rakam içermelidir. Boşluk, iki nokta ve alt çizgi içeren kodlar reddedildi.
- Yasaklı kelimeler: Başlık ya da açıklamadaki yasaklı sözcükler ürünü reddettirir; mesaj kelimeyi yazar.
Gönderim düzeni ve yanıt
Bir istekte birden fazla ürün gönderilebilir. Kod notlarına göre istek başına en fazla 1.000 ürün ve istekler arasında 5 saniyelik aralık kuralı uygulanıyor. Pratikte daha küçük parçalarla (örneğin 200 ürün) çalışmak, tek bir hatanın büyük bir partiyi etkilemesini önler.
Yanıttaki batchId (bazı yanıtlarda BatchId yazımıyla) işlemin takip numarasıdır. batchId dönmüyorsa istek kabul edilmemiştir; yanıt gövdesini kaydedin. Takip için batch-status servisine bakın. Başarılı satırlar da inceleme sürecine girer; ayrıntı ürün onay süreci sayfasındadır.
Göndermeden önce kontrol listesi
- Görselleri tekilleştirip ilk 5'ini seçin; çok büyük görseller yerine 2.000 pikseli aşmayan sürümleri kullanın.
- Stok kodunu ve barkodu Latin harf, rakam ve tireye indirin; Türkçe harfleri karşılıklarına çevirin.
- Açıklamadaki HTML'i sadeleştirin ve çok kısa açıklama bırakmayın.
- Liste fiyatını satış fiyatına eşit ya da ondan yüksek verin; indirim oranını makul tutun.
- Bilinen yasaklı kelimeleri önceden temizleyin; aynı gün aynı içerikle ikinci istek kabul edilmediği için ilk deneme önemlidir.
Sık sorulanlar
Çiçeksepeti'ne API ile ürün nasıl yüklenir?
POST https://apis.ciceksepeti.com/api/v1/Products isteğiyle, gövdede products listesi gönderilerek. Yanıt bir batchId döndürür; sonuç batch-status servisinden okunur.
Çiçeksepeti ürününe kaç görsel eklenir?
Canlıda alınan 1030 kodlu hataya göre en az 1, en fazla 5 aktif görsel. Bağlantılar tekrarlanmamalı ve görseller çok büyük olmamalıdır.
Stok kodunda Türkçe karakter kullanabilir miyim?
Canlı denemelerde model kodu ve barkodun yalnız Latin harfleri ve rakam içermesi istendi. Türkçe harfleri karşılıklarına çevirin, boşluk ve özel karakterleri tireyle değiştirin.
Ürünü yükledim ama listede yok, neden?
Kabul edilen ürünler inceleme sürecine girer ve onaylanana kadar ürün listesinde görünmeyebilir. Önce batch-status sonucunu, sonra birkaç saat sonra ürün listesini kontrol edin.
Kaynaklar
İlgili Çiçeksepeti API konuları
Son güncelleme: 27.10.2026 · Çiçeksepeti API rehberinin tamamı