Kategori Oluştur

Bir üst kategorinin altına kategori ekler. Yeni kategori sıradaki int_id değerini alır; path değeri üst kategorinin yoluna bu int_id eklenerek oluşur (1.4 → 1.4.117).

is_leaf türetilmiş bir durum değil, bir beyandır: yaprak, alt kategori yerine tokenize edilmiş varlık barındırır; bu yüzden yaprak bir üst kategorinin altında kategori oluşturma isteği reddedilir (önce üst kategorinin is_leaf değerini Kategoriyi Güncelle ile kapatın).

İstek multipart/form-data biçimindedir; böylece görsel istekle birlikte gönderilebilir. Görseli zaten barındırıyorsanız URL'sini image_url olarak gönderin. İkisi birden gönderilirse yüklenen dosya geçerli olur. Dosya kategori oluşturulduktan sonra saklanır; bu yüzden yükleme başarısız olursa kategori görselsiz kalabilir. Görseli bir güncelleme ile yeniden deneyin.

Gerekli izin: category:create

İstek

POST /v2/admin/categories

Başlıklar

Ad	Açıklama
Authorization	Zorunlu. Bearer <access_token>
Content-Type	Zorunlu. multipart/form-data (HTTP istemciniz boundary ile birlikte ayarlar)

Gövde

Alan	Tip	Zorunlu	Açıklama
parent_id	string	Evet	Üst kategorinin ID'si. Var olmalı ve yaprak olmamalıdır
name_en	string	Evet	İngilizce ad
name_tr	string	Evet	Türkçe ad
is_leaf	boolean	Hayır	Kategori alt kategori yerine tokenize edilmiş varlık barındıracaksa true. Varsayılan false
show_on_dashboard	boolean	Hayır	Kategoriyi panoda göster. Varsayılan false
image_url	string	Hayır	Zaten barındırdığınız bir görselin URL'si
image	file	Hayır	2 MB'tan küçük görsel dosyası. Sunucuda görsel depolamanın yapılandırılmış olmasını gerektirir

Örnek

curl --request POST \
  --url '{{baseUrl}}/v2/admin/categories' \
  --header 'Authorization: Bearer <access_token>' \
  --form 'parent_id=667e9251ca818a2138ed4888' \
  --form 'name_en=Venture Capital Funds' \
  --form 'name_tr=Girişim Sermayesi Fonları' \
  --form 'is_leaf=true' \
  --form 'show_on_dashboard=false' \
  --form 'image=@./venture-capital.png'

Yanıt

Yeni kategoriyle birlikte 201 Created.

{
  "id": "6911a3c2e4b0f51d2c8a7e41",
  "parent_id": "667e9251ca818a2138ed4888",
  "name": {
    "en": "Venture Capital Funds",
    "tr": "Girişim Sermayesi Fonları"
  },
  "path": "1.4.117",
  "int_id": 117,
  "image_svg": null,
  "image_url": "https://s3.tokenizationtr.com/categories/image/6911a3c2e4b0f51d2c8a7e41.png",
  "is_leaf": true,
  "show_on_dashboard": false,
  "created_at": "2026-11-09T10:15:42.318Z"
}

Yanıt Alanları

Kategoriyi Getir sayfasında açıklanan yapıdaki kategori.

Hatalar

Durum	Kod	Açıklama
400	10015	Doğrulama başarısız (parent_id, name_en ya da name_tr eksik) — details alanına bakın. Görsel 2 MB ya da daha büyükse veya sunucuda görsel yükleme yapılandırılmamışsa da döner
400	10016	parent_id geçerli bir 24 karakterlik hex ID değil
400	10002	Üst kategori bulunamadı (domain 4)
400	10003	Üst kategori bir yaprak; alt kategori barındıramaz (domain 4)

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