Arsitektur Dokumentasi

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

TULIS CMS/DEVELOPER HUB

/api-reference-admin-admin

Superadmin

Endpoint superadmin untuk mengelola seluruh sistem Tulis CMS — pengguna dan workspace. Hanya bisa diakses oleh pengguna dengan role superadmin.

Authentication

Bearer Token (JWT) — user harus memiliki role superadmin.

List All Users

Mendapatkan daftar seluruh pengguna di sistem.

Endpoint

GET /api/admin/users

Response

{
  "status": 200,
  "data": [
    {
      "id": "c3d4e5f6-3333-4444-5555-666677778888",
      "name": "Admin Tulis",
      "email": "admin@example.com",
      "role": "superadmin",
      "created_at": "2026-01-15T08:00:00Z"
    },
    {
      "id": "d4e5f6a7-4444-5555-6666-777788889999",
      "name": "Ahmad Fulan",
      "email": "ahmad@example.com",
      "role": "user",
      "created_at": "2026-01-16T09:00:00Z"
    }
  ]
}

Update User

Mengubah data pengguna (nama, role, status).

Endpoint

PUT /api/admin/users/:id

Request Body

Field	Type	Required	Description
`name`	string	tidak	Nama baru.
`role`	string	tidak	Role baru (`superadmin`, `user`).
`status`	string	tidak	Status (`active`, `suspended`).

{
  "role": "superadmin",
  "name": "Ahmad Fulan (Promoted)"
}

Response

{
  "status": 200,
  "message": "User updated"
}

Delete User

Menghapus akun pengguna secara permanen.

Endpoint

DELETE /api/admin/users/:id

Response

{
  "status": 200,
  "message": "User deleted successfully"
}

List All Workspaces

Mendapatkan daftar seluruh workspace di sistem.

Endpoint

GET /api/admin/workspaces

Response

{
  "status": 200,
  "data": [
    {
      "id": "a1b2c3d4-1111-2222-3333-444455556666",
      "name": "My First Site",
      "slug": "my-first-site",
      "owner_id": "c3d4e5f6-3333-4444-5555-666677778888",
      "created_at": "2026-01-15T08:00:00Z"
    }
  ]
}

Update Workspace

Memperbarui workspace manapun di sistem.

Endpoint

PUT /api/admin/workspaces/:id

Request Body

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

Delete Workspace

Menghapus workspace manapun di sistem.

Endpoint

DELETE /api/admin/workspaces/:id

Response

{
  "status": 200,
  "message": "Workspace deleted successfully"
}

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.