Restomenum Geliştirici
Giriş yapKayıt ol

Kategori Yazma — categories/create · update · delete ✓ Canlı

Kategori kataloğunu yazar. Scope ürünlerle aynıdır (products:write) — kategoriler ürün/menü domain'inin parçasıdır. Sahiplik/idempotency/hata/echo kuralları katalog yazma ile ortaktır.

← API Uçları · Ortak kurallar · Scope: products:write.

categories/create

POST /plugin-api/categories/create
{
  "title": "Tatlılar",               // ZORUNLU (2..100)
  "active": true,                    // ops (default true)
  "color": "#ff8800",                // ops (<=32)
  "languages": { "en": { "title": "Desserts" } },  // ops
  "idempotencyKey": "cat-1"          // ops
}
  • Yeni kategori kök ve hiçbir menüye atanmamış oluşur; menü ataması/hiyerarşi panelden yönetilir (API'de yazılamaz).
  • Yanıttaki id, ürünlerin category alanında kullanılır → önce kategori, sonra ürün (products/create).

categories/update

POST /plugin-api/categories/update
{ "id": "a0-0c", "title": "Tatlılar & İçecekler" }   // {id} + title/active/color/languages'ten en az biri

{ id } + title/active/color/languages'ten en az biri. Sahiplik kontrollü (notOwned).

categories/delete

POST /plugin-api/categories/delete
{ "id": "a0-0c" }
Kategori boş olmalı: bağlı ürün varsa (kim oluşturursa oluştursun) → plugin.catalog.categoryNotEmpty. Önce ürünleri silin/başka kategoriye taşıyın. (Kaskad silme eklentilere kapalı — güvenli ret.)

Yanıt şekli (create/update)

categories/list ile aynı şekil: { id, title, image, color, rank, active, languages }.