Çiçeksepeti API · Genel

Çiçeksepeti API hata mesajları ve çözümleri

Çiçeksepeti API hataları iki yerde görünür. İstek seviyesindeki hatalar HTTP 400 ya da 404 ile ve bir message alanıyla gelir. Ürün yükleme ve stok-fiyat işlemlerinde ise istek kabul edilse bile ürün bazında Failed sonucu dönebilir; nedenler batch-status yanıtındaki failureReasons listesinde message ve code alanlarıyla yazar. En sık nedenler görsel, karakter ve yasaklı kelime kurallarıdır.

Ürün yükleme hataları

Aşağıdaki mesajlar canlıda alınmış örneklerden derlenmiştir.

Mesaj ya da kodNedenÇözüm
1030: en az 1, en fazla 5 aktif görselGörsel yok ya da 5'ten fazlaİlk 5 görseli gönderin
Görsel boyutu uygun değildirGörsel çok büyük2.048 piksel ve üzeri reddedildi; 1.600-1.800 piksel geçti
Görsel linki tekrarlanamazAynı bağlantı iki kezGörsel listesini tekilleştirin
1002 ve 1052: yasaklı kelimelerBaşlık ya da açıklamada yasaklı sözcükMesajdaki kelimeyi çıkarıp yeniden gönderin
Model Kodu / Barkod sadece Latin alfabesi veya numara içermelidirKodda Türkçe harf, boşluk, iki nokta ya da alt çizgiKodu harf, rakam ve tireye indirin
Varyant mevcutta bulunmaktadırÜrün Çiçeksepeti'nde zaten varYeni yükleme yerine mevcut ürünü eşleştirin

Onay kuyruğu mesajları

Bazı mesajlar hata gibi görünse de ürünün durumunu anlatır:

  • PW_1065, "mevcut bir istek bulunmaktadır": Ürün için Çiçeksepeti'nin inceleme kuyruğunda açık bir istek var. Bu bir red değildir; ürün beklemededir. Aynı ürünü yeniden göndermeyin.
  • "Aynı içerikle zaten bir istek" (Batch Id ile): Aynı gün aynı içerikle gönderilmiş bir istek var. Mesajdaki Batch Id ile önceki işlemin sonucunu sorgulayın.
  • Pending ya da Processing: batch-status yanıtında ürün hâlâ işleniyor demektir. Bir süre sonra tekrar bakın.

Bu durumların ayrıntısı Çiçeksepeti ürün onay süreci sayfasındadır.

İstek seviyesindeki hatalar

  • "Limit aşımı! ... Kalan Süre: NN saniye": Sınır aşıldı; belirtilen süre kadar bekleyip yeniden deneyin.
  • "PageSize 100'den fazla olmamalıdır": Sayfa boyutunu 100 ya da altına çekin.
  • "Date Limit Exceeded": Sipariş isteğindeki tarih aralığı fazla geniş. Aralığı 14 günlük parçalara bölün.
  • 404: Yol yanlış. Siparişler için doğru yol POST /api/v1/Order/GetOrders'tır; GET /api/v1/Orders 404 döndürür. Ürün silmede 404, verilen kodla ürün bulunamadığını gösterir.
  • Boş sipariş listesi ve uyarı: Tarih tam ISO biçiminde gönderilmezse istek 200 dönüp boş liste ve warningMessage verebilir.

Hataları azaltmak için

  • Göndermeden önce kendi tarafınızda doğrulayın: görsel sayısı, kod karakterleri, açıklama uzunluğu ve fiyatlar.
  • Daha önce ret aldığınız yasaklı kelimeleri bir listede tutup yeni ürünlerde otomatik temizleyin. Aynı gün aynı içerikle ikinci istek kabul edilmediği için ilk denemenin temiz olması önemlidir.
  • failureReasons içindeki code değerini saklayın; mesaj metni değişse bile kod üzerinden hata türünü tanırsınız.
  • Kalıcı hataları (kural ihlali) geçici olanlardan (limit, beklemede) ayırın. Kalıcı hatayı yeniden denemek yalnız limit süresini tüketir.

Sık sorulanlar

Çiçeksepeti PW_1065 hatası ne demek?

"Mevcut bir istek bulunmaktadır" anlamına gelir: ürün için inceleme kuyruğunda açık bir istek vardır. Bu bir red değildir; aynı ürünü yeniden göndermeden incelemenin bitmesini bekleyin.

Çiçeksepeti yasaklı kelime hatasını nasıl çözerim?

Hata mesajı "yasaklı kelimeler:" ifadesinden sonra kelimeyi yazar. Bu kelimeyi başlık ve açıklamadan çıkarıp ürünü yeniden gönderin.

Çiçeksepeti'ye kaç görsel gönderebilirim?

Canlıda alınan 1030 koduna göre en az 1, en fazla 5 aktif görsel kabul ediliyor. Görsel bağlantıları tekrarlanmamalı ve görseller çok büyük olmamalıdır.

Kaynaklar

İlgili Çiçeksepeti API konuları

Son güncelleme: 27.10.2026 · Çiçeksepeti API rehberinin tamamı

Çiçeksepeti entegrasyonunu kod yazmadan kurun

Saystok bu API'lerle stok, sipariş ve fiyatı sizin yerinize eşitler. 30 gün ücretsiz.