Yanıttaki ürün alanları
| Alan | Anlamı |
|---|---|
| productCode | Çiçeksepeti'nin ürün kodu; silmede kullanılır |
| stockCode | Satıcı stok kodu; stok ve fiyat bununla güncellenir |
| mainProductCode | Ana ürün (model) kodu |
| productName | Ürün adı |
| categoryId, categoryName | Kategori |
| stockQuantity | Stok adedi |
| salesPrice, listPrice | Satış ve liste fiyatı |
| barcode | Barkod |
| isActive | Ürünün aktif olup olmadığı |
| productStatusType | Ürün durum tipi |
| variantName | Seçenek adı |
| images | Görseller |
Sayfalama
Çalışan bir entegrasyonda ilk sayfa Page=1 ile istenir ve toplam sayfa sayısı totalCount değerinin sayfa boyutuna bölünmesiyle bulunur. 1.250 ürünlük bir mağazada PageSize=100 ile 13 sayfa gerekir.
- PageSize sınırı: 100'ü aşan değer "PageSize 100'den fazla olmamalıdır" mesajıyla 400 alır.
- Sayfalar arası bekleme: Farklı istekler arasında 5 saniyelik sınır görüldüğü için sayfalar arasında 5-6 saniye bekleyin.
- Aynı istek: Aynı parametrelerle aynı isteğin 10 dakikada bir kez kabul edildiği görüldü. Tam listeyi bir kez çekip önbellekte tutun.
Listede görünmeyen ürünler ve görsel biçimleri
Kod notlarına göre onay bekleyen ürünler bu listede dönmüyor. Yeni yüklediğiniz bir ürünü burada göremiyorsanız önce ürün onay sürecine bakın.
Tersi de önemlidir: Çiçeksepeti panelinden kaldırılan bir ürün artık yanıtta yer almaz. Kendi kayıtlarınızı yalnız yanıtta gelenlerle güncelliyorsanız, listeden kalkan ürünler sizde aktif görünmeye devam eder. Listeden kalkanları ayrıca tespit edip pasife alın; ama yanıt şüpheli derecede küçükse (kesinti ya da parça yanıt) toplu pasife alma yapmayın.
images alanı farklı biçimlerde gelebiliyor: bağlantı listesi, virgülle ayrılmış tek bir metin ya da url alanlı nesneler. Ayrıştırıcınız üç biçimi de okumalı ve yalnız http ile başlayan bağlantıları almalıdır.
Sık hatalar
- Her ekranda yeni istek: Kullanıcının her yenilemesi aynı isteği tetiklerse limit mesajı alırsınız.
- Listeyi stok kaynağı saymak: Siparişle düşen stok listeye gecikmeyle yansıyabilir. Stok kararını sipariş akışıyla birlikte verin.
- Kodları karıştırmak: Stok ve fiyat stockCode ile, silme productCode ile yapılır.
- Pasif ürünleri atlamak: isActive false olan ürünler de listede gelir; satışta olmadıklarını ayrıca işaretleyin.
- Sayfa boyutunu küçük tutmak: PageSize=10 gibi küçük bir değer, sayfa sayısını ve dolayısıyla bekleme süresini katlar. Sınır olan 100'ü kullanın.
Sık sorulanlar
Çiçeksepeti ürünleri API ile nasıl listelenir?
GET /api/v1/Products isteğine Page ve PageSize parametreleri verilir. PageSize en fazla 100'dür; toplam sayfa sayısı totalCount değerinden hesaplanır.
Neden aynı listeyi kısa sürede tekrar çekemiyorum?
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.
Yeni yüklediğim ürün listede yok, sorun mu var?
Büyük olasılıkla ürün incelemededir. Onay bekleyen ürünler listede dönmüyor; batch sonucunu kontrol edin ve onayı bekleyin.
productCode ile stockCode arasındaki fark nedir?
productCode, Çiçeksepeti'nin ürüne verdiği koddur ve silme gibi işlemlerde kullanılır. stockCode sizin belirlediğiniz koddur; stok ve fiyat güncellemesi bu kodla yapılır. İkisini kendi kaydınızda ayrı alanlarda saklayın.
Kaynaklar
İlgili Çiçeksepeti API konuları
Son güncelleme: 27.10.2026 · Çiçeksepeti API rehberinin tamamı