Dört marka servisi
| Servis | Yöntem ve yol | Parametre | Ne zaman |
|---|---|---|---|
| Marka listesi | GET /pim/brand | page, size | Tüm markaları sayfa sayfa indirmek |
| Ad filtresi | GET /pim/brand/by-name | title | Adı bilinen markayı bulmak |
| Ad araması | GET /pim/brand/search-by-name | title | Adla arama yapmak |
| ID sorgusu | GET /pim/brand/{markaId} | Yolda ID | Elinizdeki ID'nin hangi marka olduğunu doğrulamak |
Dokümandaki örneklerde by-name ve search-by-name tek bir marka nesnesi döndürür, liste servisi ise dizi döndürür. Kodunuz iki biçimi de karşılamalıdır: yanıt diziyse ilk uygun kaydı, nesneyse kaydın kendisini alın. Hiçbir marka servisi yolda Satıcı ID istemez.
Yanıt alanları
| Alan | Anlamı |
|---|---|
| id | brandId olarak gönderilecek değer |
| title | Markanın idefix'teki adı |
| slug | Vitrin adresindeki kısa ad, ör. apple-1000108 |
| exclusiveBrand | Münhasır marka bilgisi |
| bookPublisher | false ise marka, true ise yayınevi |
| description, metaTitle, logo | Vitrin ve arama bilgileri; çoğu kayıtta boş |
exclusiveBrand alanının anlamı dokümanda ayrıca açıklanmaz. Ancak ürün oluşturma hatalarındaki BRAND_EXCLUSIVE_NOT_AUTHORIZED kodu, münhasır bir markaya yetkisiz ürün açılamadığını gösterir.
Marka mı, yayınevi mi?
idefix kitapla tanınan bir pazaryeri olduğu için yayınevleri de marka listesinde yer alır. Kitap dışı ürünlerde bookPublisher=false olan kaydı seçin. Ad aramasında birden fazla sonuç gelirse önce adın birebir eşleşmesine, sonra bookPublisher değerine bakın.
Marka adlarında yazım farkı sık görülür: kısaltma, Türkçe karakter, büyük-küçük harf ya da "&" ile "ve" farkı. Kendi kataloğunuzdaki marka adlarını idefix'teki karşılıklarıyla bir kez eşleştirip saklamak, her yüklemede aynı aramayı tekrarlamaktan iyidir.
Markanız idefix'te hiç yoksa dokümandaki servis listesinde marka oluşturma servisi bulunmaz. Marka tanımı için idefix ile iletişime geçmeniz gerekir; tanım yapılana kadar o markanın yeni ürünleri create ile açılamaz. Barkodu katalogda olan ürünler ise marka aramadan hızlı ürün ekleme ile listelenebilir.
Sık hatalar ve çözümleri
| Hata | Neden | Çözüm |
|---|---|---|
| BRAND_NOT_EXIST | Gönderilen brandId idefix'te yok | ID'yi marka servislerinden yeniden alın |
| BRAND_FAILED_TO_MATCH | Ürün katalogda başka markayla kayıtlı | Yanıtta dönen doğru marka ID'sini kullanın |
| VENDOR_BRAND_ACCESS_DENIED | Markaya erişim yetkiniz yok | Marka yetkisini idefix'ten isteyin |
| BRAND_EXCLUSIVE_NOT_AUTHORIZED | Münhasır markaya yetkisiz ürün | Yetki için idefix ile görüşün |
| Marka adı bulunamıyor | Yazım farkı | Kısa ve farklı yazımlarla arayın |
| Yanlış kayıt seçildi | Yayınevi kaydı marka sanılmış | bookPublisher=false olanı seçin |
Sık sorulanlar
idefix brandId nereden alınır?
GET /pim/brand/search-by-name?title=MARKA servisinden. Yanıttaki id alanı, ürün oluştururken brandId olarak gönderilir.
bookPublisher true ne demek?
Kaydın marka değil yayınevi olduğunu gösterir. Kitap dışı ürünlerde bookPublisher=false olan kaydı seçin.
Markam idefix'te yoksa ne yapmalıyım?
API'de marka oluşturma servisi yoktur. Marka tanımı için idefix ile iletişime geçin; o zamana kadar barkodu katalogda olan ürünleri hızlı ürün ekleme ile listeleyebilirsiniz.
Marka listesini tamamen indirmek gerekir mi?
Gerekmez. Adını bildiğiniz markayı search-by-name ya da by-name ile tek istekte bulabilirsiniz. Liste servisi page ve size parametreleriyle sayfalıdır.
Kaynaklar
İlgili idefix API konuları
Son güncelleme: 27.10.2026 · idefix API rehberinin tamamı