İçerik ve Ayarlar
Anasayfa Modülleri
E-ticaret sitesine ait anasayfa yerleşimi ile ilgili modül ve slider bilgilerini bu servis aracılığı ile listeleyebilirsiniz.
Modülleri Listeleme
Bu servis, anasayfa yerleşimi için gerekli olan modül ve head (seo başlık, açıklama vb.) bilgilerini listelemektedir.
Önemli not : B2B kullanıcıları için B2C ve B2B olmak üzere birden fazla anasayfa şablonu vardır. Şablon tipi ön tanımlı olarak B2C'dir. templateId parametresi göndererek, dilediğiniz zaman B2B şablonunu getirebilirsiniz.
Bearer Token ile üye token bilgisi gönderilirse, üyeye özel sonuçlar dönülebilir. Örneğin ürünün favoriye eklenme durumu, üyeye özel indirim yada fiyatlandırma vb.
Parametre Tanımlamaları
Aşağıdaki parametreler ile ürün detay servisine istek yapabilirsiniz.
| Değerler | Zorunluluk | Ön Tanımlı | Açıklama |
|---|---|---|---|
| lang | hayır | tr | Servisten beklenen dil bilgisidir. Merchant'a tanımlı dil bilgileri ile istek yapılabilir. |
| warehouseId | hayır | Çoklu depo kullanan satıcılar için depo id bilgisidir. Gönderilen depo id'sine ait deponun fiyat ve stok bilgileri listelenir. Veri gönderilmezse, ön tanımlı depoya ait ürünler listelenir. | |
| templateId | hayır | 0 | 0 : B2C şablonu - 1 : B2B şablonu |
Örnek İstek
axios.get('{baseUrl}/api/shop/homepage')
Servis Cevabı ve Alan Açıklamaları
| Alan adı | Açıklama |
|---|---|
| widgets | Anasayfa modüllerini içerir |
| head | Frontend ve SEO için gerekli olan bilgileri içerir |
| head->title | SEO başlık bilgisi |
| head->description | SEO açıklaması |
| head->htmlContent | Varsa sayfaya özel HTML içeriği |
| head->canonicalUrl | SEO canonical URL bilgisi |
| head->breadcrumbList | Sayfa breadcrumb bilgisi |
{
"widgets": [
{
"title": null,
"subTitle": null,
"placement": "left",
"customClass": null,
"isActive": 1,
"sortId": 2,
"moduleType": "simple_box",
"content": [
{
"title": "",
"subTitle": "",
"ctaText": "",
"ctaLink": "",
"desktopImage": "http://localhost/uploads/assets/banners/10011/original/a2e734c1-c100-4019-8b49-576742237495.png",
"mobileImage": "http://localhost/uploads/assets/banners/10011/original/a2e734c1-c100-4019-8b49-576742237495.png",
"customClass": null,
"isActive": null,
"sortId": 0,
"config": {
"ctaClass": "",
"isCtaShow": false,
"isTitleShow": false,
"linkIsOutbox": false,
"imgHPlacement": "center",
"imgVPlacement": "middle",
"titleIsOutbox": false,
"titleHPlacement": "",
"titleVPlacement": ""
}
}
],
"filters": [],
"viewAllLink": null,
"config": {}
},
{
"title": "Çok Satanlar",
"subTitle": null,
"placement": "left",
"customClass": "my-10",
"isActive": 1,
"sortId": 3,
"moduleType": "best_sellers",
"content": [],
"filters": [
{
"id": 852,
"filter_name": "Makyaj"
},
{
"id": 877,
"filter_name": "Saç Bakım"
},
{
"id": 1089,
"filter_name": "Anne & Bebek Bakım"
}
],
"viewAllLink": null,
"config": {
"defaultValue": null,
"defaultCategory": 1089,
"filterCategories": [
1089,
877,
852
]
}
}
],
"head": {
"title": "Türkiye'nin Kozmetik Markası",
"description": null,
"keywords": null,
"canonicalUrl": "",
"breadcrumbList": []
}
}
Widget Modeli
| Alan adı | Veri Tipi | Açıklama |
|---|---|---|
| title | String | Başlık bilgisi |
| subTitle | String | Alt başlık bilgisi |
| placement | String | Başlık yerleşimi (left, right, center) |
| customClass | String | CSS sınıfı |
| isActive | Integer | Modül aktif/pasif durumu |
| sortId | Integer | Sıralama bilgisi |
| moduleType | String | Modül tipi, dinamik component çağırmak için kullanılabilir |
| filters | Array | Varsa modül filtreleme seçenekleri |
| viewAllLink | String | "Tümünü göster" bağlantısı |
| config | Object | Varsa özel modül konfigürasyonu |
| isDynamic | Boolean | Modül dinamik durumu, çok satan ürünler gibi modül tiplerinde true olarak gelir |
| content | Array | Modül içeriği |
isDynamic değeri true ise Product modeline ait veri döner, false ise aşağıdaki veri modeli döner.
Widget Content Modeli
| Alan adı | Veri Tipi | Açıklama |
|---|---|---|
| title | String | Başlık bilgisi |
| subTitle | String | Alt başlık bilgisi |
| ctaText | String | Varsa, link başlığı |
| ctaLink | String | Varsa, link bilgisi |
| desktopImage | String | Masaüstü görseli (default) |
| mobileImage | String | Varsa, mobil görseli (opsiyonel) |
| isActive | Integer | Aktiflik durumu |
| sortId | Integer | Sıralama değeri |
| config->ctaClass | String | Link elementi için CSS sınıfı |
| config->isCtaShow | Boolean | Link butonu göster/gösterme |
| config->isTitleShow | Boolean | Başlık bilgisini göster/gösterme |
| config->imgHPlacement | String | Yatay görsel hizası (left,center,right) |
| config->imgVPlacement | String | Dikey görsel hizasıe (top,middle,bottom) |
| config->titleIsOutbox | Boolean | Başlık görsel üzerinde/dışında olsun |
| config->titleHPlacement | String | Yatay başlık hizası (left,center,right) |
| config->titleVPlacement | String | Dikey başlık hizası (top,middle,bottom) |