Gövde alanları
| Alan | Örnek | Not |
|---|---|---|
| page | 0 | Sayfa numarası 0'dan başlar |
| pageSize | 100 | Sayfa başına kayıt; 100'ü aşmayın |
| startDate | 2026-10-13T09:00:00.000Z | Tam ISO biçimi, milisaniye ve Z ile |
| endDate | 2026-10-27T09:00:00.000Z | Aralık en fazla yaklaşık 14 gün |
Yanıtta dört alan gelir: orderListCount (toplam kayıt), pageCount (sayfa sayısı), supplierOrderListWithBranch (sipariş kalemleri listesi) ve warningMessage (uyarı metni). Listede her satır bir sipariş kalemidir; aynı siparişin birden fazla satırı olabilir. Ayrıntı: Çiçeksepeti sipariş detayı ve kalemler.
Tarih biçimi tuzağı
Bu serviste en çok zaman kaybettiren konu tarih biçimidir. Canlı incelemede şu görüldü: tarih saniyeye kadar ve Z olmadan gönderildiğinde istek 200 dönüyor, warningMessage alanında "user-agent uyuşmuyor" benzeri bir uyarı geliyor ve sipariş listesi boş kalıyor. Asıl neden User-Agent değil, tarih biçimiydi.
- Doğru: 2026-10-27T09:00:00.000Z
- Sorunlu: 2026-10-27T09:00:00
Liste beklenmedik şekilde boş geliyorsa önce tarihleri, sonra warningMessage alanını kontrol edin.
Aralık, sınır ve sayfalama
Tek istekte 14 günlük aralık çalıştı, 20 günlük aralık "Date Limit Exceeded" hatası verdi. 30 günlük bir dönemi çekmek için aralığı 14 günlük pencerelere bölün.
Servise dakikada bir istek kabul edildiği görüldü; sınır aşılınca "Limit aşımı ... dakikada 1 kez ... Kalan Süre" mesajı gelir. Bu yüzden:
- Pencereler arasında bekleyin ve limit mesajında kalan süre kadar durun.
- Aynı mağaza için farklı ekranların aynı listeyi ayrı ayrı istemesini önleyin; tek bir çağrının sonucunu birkaç dakika ortak kullanın.
- pageCount 1'den büyükse sonraki sayfaları da isteyin. Yoğun bir mağazada 14 günde 100'den fazla kalem olabilir.
- Bir pencere hata verirse diğer pencerelerin sonucunu atmayın; eksik pencereyi sonra yeniden deneyin.
Sık hatalar
- GET ile istemek: GET /api/v1/Orders 404 döner; doğru yol POST /api/v1/Order/GetOrders'tır.
- Kısaltılmış tarih: Boş liste ve yanıltıcı bir uyarı üretir.
- Uzun aralık: 14 günü aşan aralık hata verir.
- Hata sonucunu önbelleğe yazmak: Limit ya da ağ hatasında boş listeyi "sipariş yok" diye saklamak, ekranın dakikalarca yanlış görünmesine yol açar.
- Kalemi sipariş sanmak: Satırları orderId ile gruplamadan sipariş saymak, sipariş sayısını şişirir.
Sık sorulanlar
Çiçeksepeti siparişleri API ile nasıl çekilir?
POST https://apis.ciceksepeti.com/api/v1/Order/GetOrders isteğiyle. Gövdede page, pageSize, startDate ve endDate gönderilir; tarihler milisaniyeli ve Z ekli tam ISO biçiminde olmalıdır.
Çiçeksepeti sipariş listesi neden boş geliyor?
En sık neden tarih biçimidir. Saniyeye kadar kısaltılmış, Z eki olmayan tarihlerde istek 200 dönüp boş liste ve bir uyarı verebiliyor. Tarihleri tam ISO biçiminde gönderin.
Tek istekte kaç günlük sipariş çekilebilir?
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.
Sipariş servisine ne sıklıkla istek atılabilir?
Canlı kullanımda dakikada bir istek sınırı görüldü. Sonucu birkaç dakika önbelleğe alıp farklı ekranlarda ortak kullanmak gerekir.
Kaynaklar
İlgili Çiçeksepeti API konuları
Son güncelleme: 27.10.2026 · Çiçeksepeti API rehberinin tamamı