Ağaç nasıl okunur?
Ağacın her düğümünde bir ID, bir ad ve alt kategori listesi bulunur. Canlıda çalışan entegrasyon bu bilgileri şu alan adlarıyla arar:
| Bilgi | Denenen alan adları |
|---|---|
| Kategori ID'si | id, categoryId |
| Kategori adı | name, categoryName, displayName |
| Alt kategoriler | subCategories, children, childs, subs, items |
| Kök liste | Yanıtın kendisi ya da items, data, categories alanı |
Bu kadar çok yedek ad bulunması, alanların resmî dokümanla doğrulanmadığını gösterir. Kendi entegrasyonunuzda ilk yanıtı kaydedip gerçek alan adlarına bakın ve okuyucunuzu ona göre sadeleştirin.
Kategori ağacı, ürün ve sipariş servisleri gibi data sarmalı içinde gelebilir. Yanıtın kendisi bir dizi değilse önce sarmalı açın, sonra kök listeyi arayın. Kök liste boş geliyorsa ağaç alanı farklı bir adla dönüyor olabilir; ham yanıtı kaydetmek burada da en hızlı teşhis yoludur.
Yaprak kategoriyi bulma
- Kök listeden başlayın.
- Her düğümde alt kategori dizisine bakın; doluysa içine inin.
- Alt dizisi boş olan düğüm yapraktır; ID'sini ve tam yolunu kaydedin.
- Yolu "Üst › Alt › Yaprak" biçiminde birleştirin; arama kutusunda bu yol kullanılır.
| Örnek yol | Yaprak mı |
|---|---|
| Ev › Mutfak | Hayır, altında kategoriler var |
| Ev › Mutfak › Bardak | Evet, altında kategori yok |
Tablodaki yollar yalnız örnektir; Pazarama'nın gerçek kategori adları ve ID'leri ağaçtan okunur.
Kategori ağacı ne için kullanılır?
Ürünlerde çoğu zaman kategorinin adı değil kodu saklanır. Ağaç, bu kodu insanların okuyabileceği bir yola çevirmek için gerekir. Kanallar arası kategori eşleştirmesinde de ağaçtaki yaprak kategoriler hedef listeyi oluşturur; mantığı kategori eşleştirme rehberinde anlatılıyor.
Pazaryerlerinde ürün genelde en alt kategoriye açılır. Pazarama'nın ürün açma kuralları ve kategori özelliklerini (attribute) veren servis bu rehberde doğrulanamadı; ürün açacaksanız bunları entegrasyon dokümanından kontrol edin.
Ağaç büyük olabilir ve sık değişmesi beklenmez. Her istekte yeniden çekmek yerine bir gün gibi uzun bir süre önbellekte tutun.
Ağacı düzleştirip yaprak kategorileri yol metniyle saklamak aramayı kolaylaştırır. Kullanıcı "bardak" yazdığında yolunda bu kelime geçen yaprakları göstermek, ağaçta tek tek gezinmekten çok daha hızlıdır. Yaprak adı aramayla birebir eşleşen sonuçları listenin üstüne almak doğru kategoriyi seçmeyi hızlandırır.
Sık hatalar ve çözümleri
- Ara kategoriyi seçmek: altında kategori olan düğüme ürün açmayın.
- ID yerine adı saklamak: ad değişebilir; ID kalıcıdır.
- Alan adlarını tek bir varsayıma bağlamak: ilk yanıtı kaydedip doğrulayın.
- Ağacı her ürün için yeniden indirmek: önbellek kullanın.
- Yaprak adının tek başına yeterli sanılması: aynı ad farklı dallarda olabilir; tam yolu kullanın.
Sık sorulanlar
Pazarama kategori listesi hangi servisten alınır?
GET /product/getCategoryTree servisinden. Ağacın tamamı tek istekte döner.
Hangi kategoriye ürün açılabilir?
Pazaryerlerinde genel kural en alt (yaprak) kategoridir. Pazarama'nın ürün açma kuralı bu rehberde doğrulanamadı; entegrasyon dokümanından kontrol edin.
Kategori özellikleri hangi servisten gelir?
Bu rehberde doğrulanamadı. Canlıda çalışan entegrasyon kategori özelliklerini çekmiyor; servis bilgisi İş Ortağım panelindeki entegrasyon dokümanındadır.
Kategori ağacını ne sıklıkla güncellemeliyim?
Her istekte değil. Önbellekte uzun süre, örneğin bir gün, tutup belirli aralıklarla yenilemek yeterlidir.
Kaynaklar
İlgili Pazarama API konuları
Son güncelleme: 27.10.2026 · Pazarama API rehberinin tamamı