Yanıttaki alanlar
Yanıt üst seviyede categoryId ve categoryName, ardından categoryAttributes listesini içerir.
| Alan | Anlamı |
|---|---|
| attributeId | Özellik numarası; yüklemede Attributes.Id |
| attributeName | Özelliğin adı |
| required | true ise zorunlu |
| varianter | true ise ürün seçeneklerini ayıran (varyant) özellik |
| type | Özelliğin tipi |
| attributeValues | İzinli değerler; her biri id ve name alanlı |
attributeValues içindeki id değeri, yüklemede ValueId olarak gönderilir. name alanı ise kullanıcıya gösterilecek değer adıdır; eşleştirme tablonuzda adı değil id'yi saklayın, çünkü adlar düzeltilebilir.
Bir kategoride hem zorunlu hem varyant olan özellikler bulunabilir. Bu özellikler hem her üründe gönderilmeli hem de seçenekler arasında farklı değer almalıdır. Kategori seçiminden hemen sonra listeyi kullanıcıya göstermek, eksik bilgiyi yükleme öncesinde yakalamanın en kolay yoludur.
Attributes alanını doldurmak
Ürün yükleme isteğinde özellikler Attributes adlı bir listeyle gider. Çalışan bir entegrasyonda her satır üç alanla gönderilir: Id, ValueId ve TextLength. Örnek satır: Id: OZELLIK_ID, ValueId: DEGER_ID, TextLength: 0.
Alan adlarının yazımına dikkat edin. Bu entegrasyonda büyük harfle başlayan Attributes, Id ve ValueId yazımı kullanılıyor; kod notlarına göre yazım hatası düzeltilmeden önce gönderilen ürünler "en az 1 varyant" türü bir hatayla karşılaşmıştı.
- required true: Bu özelliği göndermek zorundasınız.
- varianter true: Bu özellik ürün seçeneklerini ayırır. Aynı modelin renk ya da ölçü seçenekleri bu özellikle farklılaşır.
- attributeValues boş değilse: Değeri listeden seçin ve id'sini gönderin.
Varyant ve model kodu
Çiçeksepeti ürün yükleme isteğinde iki kod alanı bulunur: mainProductCode ve stockCode. stockCode her seçeneğin benzersiz kodudur. mainProductCode ise ana ürün kodudur; aynı modelin seçeneklerini bir araya getirmek için kullanılır. Tek seçenekli bir üründe iki alana aynı değer yazılabilir.
Varyantlı bir ürün gönderirken her seçenekte varianter özelliğine farklı bir değer verin ve seçenekleri aynı mainProductCode ile gönderin. Aynı seçenek ikinci kez gönderilirse "Varyant mevcutta bulunmaktadır" yanıtı gelir.
Sık hatalar ve öneriler
- Eksik zorunlu özellik: Kategori değiştiğinde zorunlu özellikler de değişir. Kategoriyi değiştirdiyseniz listeyi yeniden çekin.
- Başka kategorinin değeri: ValueId, o kategorinin attributeValues listesinden gelmelidir.
- Alan adı yazımı: Attributes, Id ve ValueId yazımını değiştirmeyin.
- Her üründe yeniden sorgu: Aynı kategorinin özelliklerini önbelleğe alın; Çiçeksepeti'nin istek sınırları sık sorguyu cezalandırır.
- Otomatik değer seçimine güvenmek: Zorunlu bir özelliği listedeki ilk değerle doldurmak ürünü geçirebilir ama müşteriye yanlış bilgi gösterebilir. Gerçek değeri seçin.
Sık sorulanlar
Çiçeksepeti zorunlu özellikleri nasıl öğrenirim?
GET /api/v1/Categories/{categoryId}/attributes isteğiyle. Yanıtta required değeri true olan özellikler zorunludur; varianter true olanlar ürün seçeneklerini ayırır.
Özellik değeri hangi alanla gönderilir?
Ürün yükleme isteğindeki Attributes listesinde, her satırda Id (özellik numarası) ve ValueId (attributeValues içindeki değer numarası) ile.
"Varyant mevcutta bulunmaktadır" ne demek?
Gönderdiğiniz seçenek Çiçeksepeti'nde zaten kayıtlıdır. Aynı ürünü yeniden yüklemek yerine mevcut ürünü kendi sisteminizle eşleştirin.
Kategori özelliklerini her ürün için yeniden sorgulamalı mıyım?
Gerek yok. Aynı kategorideki ürünler aynı özellik listesini kullanır. Listeyi kategori başına önbelleğe alın; Çiçeksepeti'nin istek sınırları sık sorgunun limit mesajı üretmesine yol açar.
Kaynaklar
İlgili Çiçeksepeti API konuları
Son güncelleme: 27.10.2026 · Çiçeksepeti API rehberinin tamamı