Kategori Listesi V1

Ürün kategorileri hiyerarşik olarak düzenlenir. Bu sayfa kategori ağacını, alt kategori sorgulamalarını ve ürün işlemlerinde doğru kategori kimliğinin nasıl kullanılacağını açıklar.

Kategorileri Listeleme

GET /api/categories

Bulbulustur ürün kategori ağacından kategori referanslarını sayfalı listeler. Bu veriler dil bazında mevcut sunucu belleği önbelleğinden sağlanır.

Parametreler

pageinteger · Opsiyonel

Varsayılan 1; en küçük 1.

sizeinteger · Opsiyonel

Varsayılan 50; en çok 100 kayıt. Gereksiz büyük kategori indirmeleri yerine sayfalama kullanın.

languageIdinteger · Opsiyonel

Varsayılan 1 (Türkçe), 1–11 aralığında dil kimliği.

Kategori kimliği

Ürünlerin categoryId değeri, dönen categoryId alanıyla eşleşir. Üst kategori kimliği parentId; kök seviyede 0 olabilir.

Yanıt: 200 OK; kimlik hatası 401; istek limiti 429.

cURLGET /api/categories

curl --request GET \
  'https://developers.bulbulustur.com/api/categories?page=1&size=50&languageId=1' \
  --header 'X-Api-Key: YOUR_API_KEY' \
  --header 'X-Api-Secret: YOUR_API_SECRET' \
  --header 'Accept: application/json'

Listeleme sayfalıdır. İstek başına en fazla 100 kategori döner.

Liste Yanıtı

StoreCategoryResponse V1 · Sayfalama

data.items alanındaki her kayıt bir kategori referansıdır.

StoreCategoryResponse V1 alanları

categoryId kategori kimliği, parentId üst kategori, categoryName ilgili dilde ad, haveChild alt kategori varlığı, categoryLevel hiyerarşi seviyesidir.

Tipler ve null bilgisi mevcut OpenAPI V1 üzerinden otomatik üretilir.

JSON · 200 OKŞematik örnek

{
  "data": {
    "items": [
      {"categoryId": 1, "parentId": 0, "categoryName": "Örnek kategori", "haveChild": true, "categoryLevel": 1}
    ],
    "pageNumber": 1,
    "pageSize": 50,
    "totalItemCount": 1,
    "totalPageCount": 1
  },
  "count": 1
}

Şematik örnektir; gerçek kategori ID ve adları ortamınıza göre değişir.