Kategoriyi Getir

Tek bir kategoriyi döndürür. Silinmiş bir kategori bulunamaz.

Gerekli izin: category:view

İstek

GET /v2/admin/categories/{category_id}

Parametreler

Ad	Tip	Konum	Açıklama
category_id	string	path	Zorunlu. Kategori ID'si (24 karakterlik hex)

Başlıklar

Ad	Açıklama
Authorization	Zorunlu. Bearer <access_token>

Örnek

curl --request GET \
  --url '{{baseUrl}}/v2/admin/categories/677ed6e3cc111aea14a3dfb8' \
  --header 'Authorization: Bearer <access_token>'

Yanıt

{
  "id": "677ed6e3cc111aea14a3dfb8",
  "parent_id": "677ed6e3cc111aea14a3dfb7",
  "name": {
    "en": "Fixed Deposit",
    "tr": "Vadeli Mevduat"
  },
  "path": "1.4.115.116",
  "int_id": 116,
  "image_svg": null,
  "image_url": null,
  "is_leaf": true,
  "show_on_dashboard": false,
  "tokenization_rules": {
    "lock_salable_percentage_at_100": true,
    "rental_income_as_percentage": true,
    "sync_max_supply_with_total_value": true,
    "rental_payment_period_days": 30,
    "disallow_min_purchase_quantity": true,
    "disallow_max_purchase_quantity": true,
    "disallow_min_tokens_required_for_rental_income": true
  },
  "created_at": "2023-09-05T19:26:16.294Z"
}

Yanıt Alanları

Alan	Tip	Açıklama
id	string	Kategori ID'si
parent_id	string | null	Üst kategori ID'si. Yalnızca kökte null
name	object	Dile göre görünen ad
name.en	string	İngilizce ad
name.tr	string	Türkçe ad
path	string	Materialize yol: kökten bu kategoriye kadarki int_id değerlerinin . ile birleşimi (ör. 1.4.115.116)
int_id	integer	Oluşturulurken atanan sıralı sayısal ID. Kök 1'dir
image_svg	string | null	Satır içi SVG ikonu (yalnızca hazır yüklenmiş kategorilerde; API üzerinden yazılamaz)
image_url	string | null	Kategori görselinin URL'si (yüklenen ya da oluşturma / güncellemede verilen)
is_leaf	boolean	Kategori alt kategori yerine tokenize edilmiş varlık barındırıyorsa true. Bir yaprağın altında kategori oluşturulamaz
show_on_dashboard	boolean	Kategorinin panoda gösterilip gösterilmediği
tokenization_rules	object	Yalnızca tokenizasyon kuralı taşıyan kategorilerde bulunur: bu kategoride oluşturulan ya da güncellenen bir token'ın uyması gereken kısıtlar. API üzerinden yalnızca okunur
tokenization_rules.lock_salable_percentage_at_100	boolean	Token'ın satılabilir yüzdesi tam olarak 100 olmalıdır
tokenization_rules.rental_income_as_percentage	boolean	Kira geliri tutarı toplam değerin yüzdesi olarak okunur ve 1 ile 100 arasında olmalıdır
tokenization_rules.sync_max_supply_with_total_value	boolean	Token'ın max_supply değeri toplam değeriyle eşleşmelidir
tokenization_rules.rental_payment_period_days	integer	0'dan büyükse kira ödeme periyodu (gün) bu değere eşit olmalıdır
tokenization_rules.disallow_min_purchase_quantity	boolean	Asgari satın alma miktarı 0 olmalıdır
tokenization_rules.disallow_max_purchase_quantity	boolean	Azami satın alma miktarı 0 olmalıdır
tokenization_rules.disallow_min_tokens_required_for_rental_income	boolean	Kira geliri için gereken asgari token sayısı 0 olmalıdır
created_at	string	Oluşturulma zamanı (ISO 8601)

Hatalar

Durum	Kod	Açıklama
400	10016	category_id geçerli bir 24 karakterlik hex ID değil
400	10001	Kategori bulunamadı ya da silinmiş (domain 4)

Hata biçimi ve ortak kodlar için Hatalar sayfasına bakın.