Kategoriyi Sil
Bir kategoriyi geçici olarak siler (soft delete): kategori tüm okumalardan kaybolur. Yalnızca alt kategorisi olmayan ve kök olmayan bir kategori silinebilir.
- Alt kategorisi olan bir kategori reddedilir: silinmesi alt kategorileri sahipsiz bırakır, çünkü onların
pathdeğeri silinmiş bir üst kategoriyi gösterir. Önce alt ağacı aşağıdan yukarıya silin. - Kök kategori (
int_id1) silinemez. - Üst kategorinin
is_leafdeğeri olduğu gibi kalır: bir dalı boşaltmak onu yaprağa çevirmez.
Aynı kategoriyi ikinci kez silmek "category not found" ile yanıtlanır.
Gerekli izin: category:delete
İstek
DELETE /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 DELETE \
--url '{{baseUrl}}/v2/admin/categories/6911a3c2e4b0f51d2c8a7e41' \
--header 'Authorization: Bearer <access_token>'
Yanıt
Boş gövdeli 204 No Content.
Hatalar
| Durum | Kod | Açıklama |
|---|---|---|
| 400 | 10016 | category_id geçerli bir 24 karakterlik hex ID değil |
| 400 | 10001 | Kategori bulunamadı ya da zaten silinmiş (domain 4) |
| 400 | 10004 | Kategorinin alt kategorileri var; silinemez (domain 4) |
| 400 | 10005 | Kök kategori silinemez (domain 4) |
Hata biçimi ve ortak kodlar için Hatalar sayfasına bakın.