Yanıtın yapısı
| Alan | Tip | Anlamı |
|---|---|---|
| id | sayı | Kategori numarası; ürün yüklemede ve özellik sorgusunda kullanılır |
| name | metin | Kategori adı |
| parentCategoryId | sayı ya da null | Üst kategori; kökte null |
| subCategories | dizi | Alt kategoriler; en alt kırılımda boş dizi |
Bu yapı N11'den küçük ama önemli bir farkla ayrılır: N11'de en alt kategorinin subCategories alanı null gelirken Çiçeksepeti'nde boş dizi gelir. İki platformu aynı kodla işliyorsanız "alt kategori yok" kontrolünü hem null hem boş dizi için yapın.
En alt kategoriyi bulmak
Ağacı düz bir listeye çevirip yalnız alt kategorisi olmayan düğümleri tutmak, kullanıcıya kategori seçtirmeyi kolaylaştırır. Her düğümü gezin; alt kategorisi varsa içine inin, yoksa düğümü listeye ekleyin. Eklerken üst kategori adlarını "Ev & Yaşam > Mutfak > Bardak" gibi bir yol olarak birleştirin.
Yol bilgisi aramada da işe yarar. Kullanıcı "bardak" yazdığında yalnız adı değil yolu da aramak, aynı adlı ama farklı üst kategorideki düğümleri ayırt etmeyi sağlar. Çiçeksepeti'nde isimle kategori arayan ayrı bir servis kullanılmaz; arama indirdiğiniz ağaç üzerinde yapılır.
Kategori seçimi, ürünün hangi özellikleri zorunlu tutacağını da belirler. Kategoriyi seçtikten sonra kategori özelliklerini çekin.
Önbellek ve güncellik
Kategori ağacı büyük ve seyrek değişen bir veridir. Her ürün yüklemesinde yeniden istemek yerine belli aralıklarla çekip saklayın. Çiçeksepeti'nin istek sınırları düşünüldüğünde bu, gereksiz limit mesajlarını da önler.
- Ağacı en az saatlik önbellekte tutun, günde en az bir kez tazeleyin.
- Eşleştirme tablonuzda kategori adını değil id'yi saklayın.
- Tazelemede kaybolan id'leri işaretleyin; o kategorideki ürünleri yeniden eşleştirmeniz gerekebilir.
- Ağaçla birlikte kategori özelliklerini de önbelleğe alıyorsanız ikisini aynı anda tazeleyin; eski özellik listesi yeni kategoriyle uyuşmayabilir.
Sık hatalar
- Üst kategoriye ürün yüklemek: Ürünü alt kategorisi olan bir düğüme atamayın; en alt kırılımı seçin.
- Boş diziyi kontrol etmemek: subCategories alanının boş dizi geldiğini unutursanız bütün düğümler "alt kategorisi var" sanılır.
- Kategori adına güvenmek: Aynı ad farklı dallarda geçebilir; seçimi yol ve id ile yapın.
- Her istekte ağacı çekmek: Sınırlara takılırsınız ve yükleme yavaşlar.
Farklı pazaryerlerinin kategori ağaçlarını birbirine bağlamak için kategori eşleştirme rehberi yol gösterir.
Sık sorulanlar
Çiçeksepeti kategori listesi nasıl alınır?
GET https://apis.ciceksepeti.com/api/v1/Categories isteğiyle, x-api-key başlığı eklenerek. Bütün ağaç tek yanıtta categories dizisi olarak gelir.
Çiçeksepeti'de en alt kategori nasıl anlaşılır?
Düğümün subCategories alanı boş bir diziyse o kategori en alt kırılımdır. Ürün yüklemedeki categoryId bu düğümün id değeri olmalıdır.
Kategori ağacını ne sıklıkla yenilemeliyim?
Ağaç sık değişmez. Saatlik önbellek ve günlük tazeleme çoğu mağaza için yeterlidir. Yenilemede kaybolan kategori id'lerini kontrol edin.
Ürünü birden fazla kategoriye ekleyebilir miyim?
Ürün yükleme isteğinde tek bir categoryId alanı gönderilir. Ürünün en iyi uyduğu en alt kategoriyi seçin; farklı kategoride göstermek için ayrı bir ürün açmak çoğu zaman mükerrer kayıt sorununa yol açar.
Kaynaklar
İlgili Çiçeksepeti API konuları
Son güncelleme: 27.10.2026 · Çiçeksepeti API rehberinin tamamı