taxonomies — Web (Site Kurucu) API

PATCH/api/web/v1/taxonomies/{id}

`PATCH /api/web/v1/taxonomies/{id}` — ad ve arşiv künyesi (BLE2-13378).

OturumYol parametresi: id

🔴 **Künye yazılabilir OLMAK ZORUNDA.** Arşiv sayfası `description`ı hem `<meta>`ya hem ekrana basar; onu yazmanın hiçbir yolu olmayan bir ürün, müşteriye kategorisinin ne olduğunu ziyaretçiye anlatma imkânı vermez ve o sayfalar aramada başlıktan ibaret kalır. ⚠ Yama `coalesce`: yalnız adı düzelten bir istek künyeyi SİLMEZ (B2B-40). ⚠ Slug DEĞİŞMEZ: adres bir SÖZDÜR ve kategori adresini sessizce taşımak, paylaşılmış her bağlantıyı kırardı (yönlendirme kuralının aynı gerekçesi).

İstek

curl -X PATCH "https://{slug}--panel.web.blesyum.app/api/web/v1/taxonomies/<id>" \
  -H "Authorization: Bearer <oturum-token>" \
  -H "Accept: application/json"

Yanıt

{
  "data": "…",
  "trace_id": "01JC…"
}

DELETE/api/web/v1/taxonomies/{id}

`DELETE /api/web/v1/taxonomies/{id}`

OturumYol parametresi: id

🔴 Silmek yazıları YETİM BIRAKMAZ (BLE2-13379): `post_taxonomies` cascade ile temizlenir, YAZILAR durur. Ve alt kategoriler KÖKE çıkar (`on delete set null`) — silinmezler. Kaç yazının etkilendiği SÖYLENİR.

İstek

curl -X DELETE "https://{slug}--panel.web.blesyum.app/api/web/v1/taxonomies/<id>" \
  -H "Authorization: Bearer <oturum-token>" \
  -H "Accept: application/json"

Yanıt

{
  "data": "…",
  "trace_id": "01JC…"
}

POST/api/web/v1/taxonomies/{id}/merge

`POST /api/web/v1/taxonomies/{id}/merge` — taksonomi birleştirme (BLE2-13380).

OturumYol parametresi: id

# 🔴 Neden ayrı bir uç (silip yeniden etiketlemek YETMEZ) Bir etiketi silip yazıları elle yeniden etiketlemek 200 yazıda 200 işlemdir ve arada kalan her yazı **etiketsiz** kalır. Birleştirme TEK transaction'da olur: bağlar taşınır, kaynak silinir, kaç yazının taşındığı SÖYLENİR. # 🔴 ASLA * **Farklı türleri birleştirme.** Kategori bir hiyerarşi, etiket bir düzlemdir; bir kategoriyi etikete katmak sessizce bir ağaç dalını düşürür. * **Kendine birleştirme.** Kaynak silinir ve yazılar HİÇBİR yere bağlanmaz. * **Mükerrer bağ bırakma.** Bir yazı iki taksonomide birden olabilir; `on conflict do nothing` olmadan taşıma unique kısıtta patlar ve birleştirme "bazen çalışıyor" gibi görünür. * **Kaynağın ÇOCUKLARINI yetim bırakma.** Alt kategoriler hedefe bağlanır; yoksa köke terfi ederler ve müşterinin ağacı SESSİZCE yeniden kurulur.

İstek

curl -X POST "https://{slug}--panel.web.blesyum.app/api/web/v1/taxonomies/<id>/merge" \
  -H "Authorization: Bearer <oturum-token>" \
  -H "Accept: application/json"

Yanıt

{
  "data": "…",
  "trace_id": "01JC…"
}