Arsitektur Dokumentasi

Peta jalan panduan, SDK integration, dan API reference lengkap yang disiapkan secara terstruktur.

TULIS CMS/DEVELOPER HUB

/api-reference-taxonomy-admin-taxonomy

Admin Taxonomy

Mengelola taksonomi (kategori dan tag) melalui Admin API. Memerlukan role editor ke atas.

Create Taxonomy

Membuat taksonomi baru (kategori atau tag).

Endpoint

POST /api/taxonomies

Authentication

Bearer Token (JWT) + X-Workspace-ID header · Role: editor+

Request Body

Field	Type	Required	Description
`name`	string	ya	Nama taksonomi (contoh: "Teknologi").
`slug`	string	tidak	Slug (auto-generated dari name).
`type`	string	ya	`category` atau `tag`.

{
  "name": "Teknologi",
  "type": "category"
}

Response

{
  "status": 201,
  "message": "Taxonomy created",
  "data": {
    "id": "a1b2c3d4-1111-2222-3333-444455556666",
    "name": "Teknologi",
    "slug": "teknologi",
    "type": "category"
  }
}

List Taxonomies

Mendapatkan daftar semua taksonomi di workspace.

Endpoint

GET /api/taxonomies

Authentication

Bearer Token (JWT) + X-Workspace-ID header · Role: editor+

Query Parameters

Parameter	Type	Default	Description
`type`	string	(semua)	Filter: `category` atau `tag`.

Get Taxonomy

Mendapatkan detail satu taksonomi.

Endpoint

GET /api/taxonomies/:id

Update Taxonomy

Memperbarui nama atau slug taksonomi.

Endpoint

PUT /api/taxonomies/:id

Request Body

Field	Type	Required	Description
`name`	string	tidak	Nama baru.
`slug`	string	tidak	Slug baru.

Delete Taxonomy

Menghapus taksonomi. Post yang terkait tidak ikut terhapus.

Endpoint

DELETE /api/taxonomies/:id

Response

{
  "status": 200,
  "message": "Taxonomy deleted"
}

Lini Masa Peluncuran Fitur

Fase 1: Setup Awal & KonfigurasiSELESAI

Docker Compose, pengaturan file environment, dan panduan setup lokal telah lengkap dibuat.

Fase 2: Referensi RESTful APISELESAI

Dokumentasi route endpoint publik, otentikasi JWT, dan kontrol hak akses telah selesai disusun.

Fase 3: Integrasi Frontend & Fitur LanjutSEDANG BERJALAN

Mempersiapkan boilerplate untuk Next.js client, manajemen revisi konten, dan optimasi query.