Katalog Kategorileri

Katalog kategorilerini listeler ve tek bir kategorinin detayını döner.

GET/v1/catalog-categoriesscope:CatalogRead

GET/v1/catalog-categories/{id}scope:CatalogRead

Yetkilendirme

Her iki endpoint CatalogRead scope'u gerektirir. Bkz. İzinler.

Query parametreleri

Liste ucunda sayfalama zorunlu — page, pageSize, orderBy, order alanları gerekir. Detay için Sayfalama sayfasına bakın.

Parametre	Tip	Açıklama
`parentId`	string(32)	Bir kategorinin alt kategorileri
`isActive`	boolean	Yalnızca aktif ya da pasif kategoriler

orderBy yalnızca CreatedAt ya da Id olabilir. Kategori adı çeviri tablosunda tutulduğu için ada göre sıralama desteklenmez.

Yanıt formatı

Liste 200 OK ile pagination header'larını (X-Total-Count, X-Page, X-Page-Size, X-Next-Page, X-Prev-Page) döner ve body yalnızca kayıt dizisidir. Detay ucu tek bir nesne döner.

{
  "id": "019da28a1e907dae9ec1a1453ca7aba8",
  "name": "Oyun Kodları",
  "slug": "oyun-kodlari",
  "parentId": "019e0001000000000000000000000004",
  "displayOrder": 0,
  "isActive": true
}

Alanlar

Alan	Tip	Açıklama
`id`	string	Kategori kimliği
`name`	string	Kategorinin Türkçe adı
`slug`	string	URL'de kullanılan kısa ad
`parentId`	string	Üst kategori; kök kategorilerde boştur
`displayOrder`	number	Aynı seviyedeki kategoriler arasındaki sıra
`isActive`	boolean	Pasif kategoriler mağazada görünmez

Hata kodları

Code	Anlam
`400`	Sayfalama veya filtre değeri geçersiz
`401`	HMAC kimlik doğrulama hatası
`403`	Gerekli scope eksik
`404`	Kategori bulunamadı
`429`	Hız limiti aşıldı