Arsitektur Dokumentasi

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

TULIS CMS/DEVELOPER HUB

/api-reference-comment-list-comments

Daftar Komentar

Melihat komentar yang sudah disetujui dan berantai (bertingkat) untuk sebuah posting. Hanya komentar approved yang dikembalikan, terstruktur sebagai thread.

Endpoint

GET /v1/posts/:post_id/comments

Autentikasi

Wajib. Berikan kunci API sebagai Bearer token dan identifikasi workspace melalui header X-Workspace-ID atau dengan mengakses API melalui subdomain workspace.

Authorization: Bearer ***
X-Workspace-ID: YOUR_WORKSPACE_ID

Atau, targetkan https://YOUR_WORKSPACE_SUBDOMAIN.YOUR_HOST sebagai pengganti mengirim X-Workspace-ID.

Parameter Path

Parameter	Tipe	Deskripsi
`post_id`	UUID	ID dari posting.

Parameter Kueri

Parameter	Tipe	Bawalan	Deskripsi
`page`	integer	`1`	Nomor halaman (berbasis 1).
`limit`	integer	`20`	Komentar per halaman.

Respons

{
  "data": [
    {
      "id": "d4e5f6a7-4444-5555-6666-777788889999",
      "post_id": "3f1a2b9c-7e4d-4c8a-9b21-0c5d6e7f8a90",
      "author_name": "Ahmad Fulan",
      "content": "Artikel yang bagus, terima kasih sudah berbagi!",
      "status": "approved",
      "created_at": "2026-01-16T10:12:00Z",
      "parent_id": null,
      "replies": [
        {
          "id": "e5f6a7b8-5555-6666-7777-888899990000",
          "post_id": "3f1a2b9c-7e4d-4c8a-9b21-0c5d6e7f8a90",
          "author_name": "Admin Situs",
          "content": "Senang Anda merasa terbantu!",
          "status": "approved",
          "created_at": "2026-01-16T11:00:00Z",
          "parent_id": "d4e5f6a7-4444-5555-6666-777788889999",
          "replies": []
        }
      ]
    }
  ],
  "meta": {
    "page": 1,
    "per_page": 20,
    "total": 3,
    "total_pages": 1
  }
}

Contoh cURL

curl "https://YOUR_HOST/v1/posts/3f1a2b9c-7e4d-4c8a-9b21-0c5d6e7f8a90/comments?page=1&limit=20" \
  -H "Authorization: Bearer ***" \
  -H "X-Workspace-ID: YOUR_WORKSPACE_ID"

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.