Yardımcı Fonsiyonlar - Shop API Docs

Bu servis, hızlı ürün arama işlemi için kullanılmaktadır. Ürün adı, model kodu ve barkod bilgisi gibi bilgilerle, ürün önerileri listelenir.

Ürün, Kategori, Koleksiyon ve Marka URL Listesi

get

/api/shop/get-url-list

Bu servis yardımıyla frontend tarafında kullanabileceğimiz ürün, kategori, koleksiyon ve markaların url slug bilgilerini listeleyebilirsiniz. URL slug bilgileri unique verilerdir ve frontend route'larını kurgularken kullanılabilir.

Özellikle Next.js framework ile Incremental Static Regeneration yapacaksanız, sayfaların önceden render edilmesi için path list verilmesi önem arz etmektedir. Bu servis aracılığı ile Shop API'ye ait path list'i kolayca çekebilirsiniz.

Parametre Tanımlamaları

Aşağıdaki parametreler ile ürün arama servisine istek yapabilirsiniz.

Değerler	Zorunluluk	Ön Tanımlı	Açıklama
urlType	evet		Listelenmek istenen URL verisi; alabileceği değerler : category,collection,product,page,brand
lang	hayır	tr	Hangi dil bilgisine ait URL bilgisini çağırmak istediğinizi belirtin. Örneğin "tr" değerini verirseniz sadece Türkçe URL bilgileri listelenir. Boş bırakırsanız satıcının desteklediği tüm dillere ait URL'ler listelenir. (İngilizce, Almanca, Türkçe vs.)

Örnek İstek

axios.get('{baseUrl}/api/shop/get-url-list?urlType=category,collection')

Servis Cevabı ve Alan Açıklamaları

Alan adı	Açıklama
slug_value	URL bilgisi
slug_id	Slug type'a ait ID bilgisi. Örneğin slug_type 'CATEGORY' ise slug_id kategori id'sini belirtir.
slug_type	URL verisinin kaynağının ne olduğunu belirtir. CATEGORY, COLLECTION, PAGE, PRODUCT, BRAND, CUSTOM
lang	Hangi dil bilgisine ait URL olduğunu belirtir

[
  {
    "slug_value": "kas-makyaji",
    "slug_id": "1064",
    "slug_type": "CATEGORY",
    "lang": "tr"
  },
  {
    "slug_value": "kas-kalemi",
    "slug_id": "1065",
    "slug_type": "CATEGORY",
    "lang": "tr"
  },
  {
    "slug_value": "kas-fari",
    "slug_id": "1066",
    "slug_type": "CATEGORY",
    "lang": "tr"
  }
]

Şablon Tipi Kontrolü

get

/api/shop/template-type

Bu servis yardımıyla frontend tarafında elde ettiğiniz URL bilgisinin hangi şablon tipine ait olduğunu öğrenebilirsiniz.

Parametre Tanımlamaları

Aşağıdaki parametreler ile ürün arama servisine istek yapabilirsiniz.

Değerler	Zorunluluk	Ön Tanımlı	Açıklama
slug	evet		Kontrol etmek istediğiniz pathname bilgisini veriniz

Örnek İstek

axios.get('{baseUrl}/api/shop/template-type?slug=sac-boyasi')

Servisten String veri tipinde bir cevap dönecektir. Alabileceğiniz cevaplar : CATEGORY, COLLECTION, PAGE, PRODUCT, BRAND, CUSTOM

"CATEGORY"