Yanıtın yapısı
Servis kök seviyede bir categories dizisi döndürür. Her düğümde dört alan vardır:
| Alan | Tip | Anlamı |
|---|---|---|
| id | sayı | Kategori numarası; ürün yüklemede categoryId olarak kullanılır |
| parentId | sayı ya da null | Üst kategori; kök kategorilerde null |
| name | metin | Kategori adı, örneğin "Banyo Süngeri & Kese" |
| subCategories | dizi ya da null | Alt kategoriler; null ise en alt kırılımdır |
Dokümandaki örnekte "Banyo & Tuvalet" kökünün altında "Küvet Ürünleri", onun altında "Küvet" yer alır. Küvet'in subCategories alanı null olduğu için ürün bu kategoriye atanabilir; Küvet Ürünleri'ne atanamaz.
En alt kırılımı bulmak
Ağacı düz bir listeye çevirmek işinizi kolaylaştırır. Her düğümü gezin, alt kategorisi olan düğümlerde aşağı inin, alt kategorisi olmayanları listeye ekleyin. Listeye eklerken üst kategori adlarını da birleştirin; "Erkek Giyim & Aksesuar > Pantolon & Şort > Erkek Jean" gibi bir yol, kullanıcıya kategori seçtirirken karışıklığı önler.
Yaprak kategoriyi neden önemsemelisiniz?
N11 ürünü yalnız en alt kırılıma kabul eder. Üst kategori id'si gönderilirse ürün görevi hata verir. Ayrıca zorunlu özellikler kategoriye göre değişir; özellik listesi de yaprak kategori için çekilir. Ayrıntı için N11 kategori özellikleri sayfasına bakın.
Önbellek ve güncellik
Kategori ağacı büyük bir yanıttır ve sık değişmez. Her ürün için yeniden indirmek yerine belli aralıklarla çekip saklayın. Yine de tamamen sabit kabul etmeyin: N11 kategori açabilir ya da kapatabilir.
N11'in hata listesinde "category alanı geçersizdir" mesajı vardır. Açıklamasına göre bu hata, ürün daha önce canlıda olan ama artık kapatılmış bir kategoriyle eşleştirildiğinde çıkar. Bu durumda kategori eşleştirmesini güncel ağaçtan yeniden yapmak gerekir.
- Ağacı günde en az bir kez yenileyin.
- Eşleştirme tablonuzdaki kategori id'lerini yeni ağaçla karşılaştırın; kaybolan id'leri işaretleyin.
- Kategori servisini 15 Ağustos 2025'ten beri anahtarsız çağıramazsınız; appKey ve appSecret başlıklarını ekleyin.
Sık hatalar
- Üst kategoriye ürün atamak: Yalnız subCategories null olan düğümlerin id'si geçerlidir.
- Kategori adını sabit kodlamak: Adlar değişebilir; eşleştirmeyi id ile tutun.
- Kapatılan kategoriyi kullanmak: "category alanı geçersizdir" hatası görürseniz ağacı yeniden çekin.
- Başlıksız istek: Kategori servisleri artık kimlik doğrulama istiyor.
Farklı pazaryerlerinin kategori ağaçları birbirine uymaz. Ürünü birden fazla kanala açıyorsanız kategori eşleştirme rehberi işinizi kolaylaştırır.
Sık sorulanlar
N11 kategori listesi nasıl alınır?
GET https://api.n11.com/cdn/categories isteğiyle. Parametre gerekmez, bütün ağaç tek yanıtta gelir. Başlıklara appKey ve appSecret eklenmelidir.
Ürünü hangi kategoriye yüklemeliyim?
En alt kırılıma. Yanıtta subCategories alanı null olan kategori en alt kırılımdır; ürün yükleme isteğindeki categoryId bu kategorinin id'si olmalıdır.
N11'de kategori adıyla arama yapan servis var mı?
Dokümanda böyle bir servis yok. Ağacı indirip kendi tarafınızda ad ve yol üzerinden arama yapmanız gerekir.
"category alanı geçersizdir" hatası ne anlama gelir?
N11'in açıklamasına göre ürün kapatılmış bir kategoriyle eşleştirilmiştir. Güncel ağacı çekip ürünü yeni bir en alt kırılıma eşleştirin.
Kaynaklar
İlgili N11 API konuları
Son güncelleme: 27.10.2026 · N11 API rehberinin tamamı