Markalar
Marka authority'si mağazadaki products.brand değerlerinden türetilir.
Endpointler
/brandsMarka listesiBrands API ne işe yarar?
Mağazada kullanılan marka değerlerini okumak için kullanılır. Brand listesi ayrı bir merkezi brand tablosundan değil mağazadaki products.brand değerlerinden türetilir.
Bu nedenle brand authority ürün kataloğudur.
Gerekli scope
GET /brands için products:read scope gerekir.
Önemli mimari fark
Brand response'u ayrı bir brand ID contract'ı sunmaz. Marka adı ve o markayı kullanan ürün sayısı üzerinden türetilmiş bir liste döner.
Entegrasyonunuz brand için var olmayan numeric brand_id varsayımı yapmamalıdır.
Response alanları
| Alan | Açıklama |
|---|---|
| name | products.brand içerisinden türetilen marka adı |
| product_count | Bu marka değerini kullanan ürün sayısı |
Meta authority
Response metadata içerisinde count ve authority bilgisi bulunabilir. authority değeri products.brand olarak brand listesinin hangi kaynaktan üretildiğini açıklar.
ERP tarafında nasıl kullanmalıyım?
BYNovax brand listesini ERP'deki marka sözlüğüyle eşleştirebilirsiniz. Ancak bunu ayrı BYNovax brand ID eşlemesi olarak tasarlamayın.
Ürün gönderirken brand alanını string değer olarak değerlendirin.
Örnek senaryo
GET /brands
Response:
Nike → 42 ürün
Adidas → 31 ürün
ERP:
"Nike" string değeri ürün brand alanıyla eşleşir.
Numeric BYNovax brand_id beklenmez.Çalıştığını nasıl doğrularım?
- GET /brands 200 dönüyor.
- Her item name ve product_count içeriyor.
- Entegrasyon ayrı brand ID varsaymıyor.
- Brand değerleri product catalog ile tutarlı işleniyor.