Çiçeksepeti API · Genel

Çiçeksepeti API istek sınırları ve "Limit aşımı" mesajı

Çiçeksepeti API sınır aşıldığında "Limit aşımı!" ile başlayan ve "Kalan Süre: NN saniye" bilgisini veren bir hata döndürür. Canlı kullanımda üç kalıp görüldü: aynı istek ürün listesinde 10 dakikada bir, sipariş listesinde dakikada bir; farklı istekler ise 5 saniyede bir kabul ediliyor. Sayfa boyutu 100'ü, sipariş tarih aralığı yaklaşık 14 günü aşamaz.

Görülen sınırlar

Aşağıdaki değerler Çiçeksepeti'ye canlıda bağlanan bir entegrasyonun kayıtlarından derlenmiştir. Resmî doküman değerleri farklıysa resmî değer geçerlidir.

KonuGözlemBelirti
Ürün listesi, aynı istek10 dakikada birTekrarlanan "Senkronize et" isteği 400 alır
Sipariş listesiDakikada bir"dakikada 1 kez" ve kalan süre mesajı
Farklı istekler5 saniyede birArka arkaya istekler limit mesajı alır
Ürün yüklemeAynı gövde dakikada bir; farklı gövde 5 saniyede birAynı gövdeyle tekrarda kalan süre hep 49-50 saniye görünebilir
Sayfa boyutuEn fazla 100"PageSize 100'den fazla olmamalıdır"
Sipariş tarih aralığı14 gün çalışıyor, 20 gün reddediliyor"Date Limit Exceeded"

Limit mesajını doğru okumak

Limit yanıtı bir hata olsa da işlemin kalıcı olarak başarısız olduğu anlamına gelmez. Mesajdaki "Kalan Süre" değeri, aynı isteği ne zaman tekrar gönderebileceğinizi söyler. İyi bir istemci şunu yapar:

  • Mesajı "Limit aşımı" ve "Kalan Süre" kalıbıyla tanır.
  • Kalan süreye birkaç saniye ekleyerek bekler.
  • İsteği aynen yeniden gönderir; en fazla birkaç kez dener.
  • Beklenen süre çok uzunsa (örneğin dakikalar) işi kuyruğa alır, kullanıcı arayüzünü bekletmez.

Limit mesajı dışındaki 400 yanıtlarını yeniden denemek işe yaramaz; gövdeyi düzeltmeniz gerekir.

Toplu işlerde strateji

  • Ürün listesini önbelleğe alın: Tam listeyi bir kez çekip 10 dakika saklayın. Görsel güncelleme ya da silme gibi işler de bu önbellekten beslensin.
  • Sayfalar arasında bekleyin: Listeyi sayfa sayfa çekerken her sayfa arasında en az 5 saniye bırakın.
  • Sipariş penceresini bölün: 30 günlük bir dönemi 14 günlük parçalara ayırın ve parçalar arasında bekleyin.
  • Sipariş sonucunu paylaşın: Aynı mağaza için farklı ekranlar aynı sipariş listesini istiyorsa tek bir çağrının sonucunu birkaç dakika ortak kullanın.
  • Yükleme gövdesini değiştirin: Aynı gövdeyi tekrar göndermek "aynı istek" sınırına takılır. Yeniden denemede ürün sırasını değiştirmek gövdeyi farklılaştırır.

Sık hatalar

  • Kullanıcının düğmeye art arda basması: Her tıklama aynı isteği gönderir ve limit süresini uzatır. Düğmeyi işlem bitene kadar kilitleyin.
  • PageSize 200: 100'ü aşan sayfa boyutu her seferinde 400 alır.
  • Tek pencerede 30 gün: Sipariş isteği tarih sınırı hatası verir ya da eksik sonuç döner.
  • Limit hatasını boş sonuç gibi saklamak: Hata alınan çağrının sonucunu "sipariş yok" diye önbelleğe yazmayın; ekran dakikalarca yanlış bilgi gösterir.

Sık sorulanlar

Çiçeksepeti "Limit aşımı" hatası ne demek?

Aynı ya da arka arkaya isteklerde sınırı aştığınızı söyler. Mesajdaki "Kalan Süre" kadar bekleyip isteği tekrar gönderdiğinizde işlem genellikle geçer.

Çiçeksepeti ürün listesi neden sık güncellenemiyor?

Canlı kullanımda ürün listesinde aynı isteğin 10 dakikada bir kez kabul edildiği görüldü. Listeyi önbelleğe alıp bu süre içinde yeniden istememek gerekir.

Çiçeksepeti'de sayfa boyutu en fazla kaç olabilir?

100. Daha büyük bir PageSize değeri "PageSize 100'den fazla olmamalıdır" mesajıyla reddedilir.

Sipariş isteğinde en fazla kaç günlük aralık verilir?

Canlı denemelerde 14 günlük aralık çalıştı, 20 günlük aralık "Date Limit Exceeded" hatası verdi. Uzun dönemleri 14 günlük parçalara bölün.

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.