Arsitektur Dokumentasi

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

TULIS CMS/DEVELOPER HUB

/api-reference-comment-create-comment

Buat Komentar

Kirim komentar baru pada sebuah posting. Pengguna tamu harus memberikan name dan email; pengguna terautentikasi memiliki id yang diatur secara otomatis. Komentar baru dibuat dengan status pending dan ditahan untuk moderasi.

Endpoint

POST /v1/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.

Badan Permintaan

CreateCommentReq:

Field	Tipe	Wajib	Deskripsi
`post_id`	UUID	ya	ID dari posting yang dikomentari.
`content`	string	ya	Badan komentar.
`name`	string	tamu	Nama tampilan penulis (wajib untuk komentar tamu).
`email`	string	tamu	Email penulis (wajib untuk komentar tamu).
`parent_id`	UUID	tidak	ID komentar induk untuk balasan berantai.

{
  "post_id": "3f1a2b9c-7e4d-4c8a-9b21-0c5d6e7f8a90",
  "content": "Ini sangat membantu, terima kasih!",
  "name": "Pembaca Tamu",
  "email": "tamu@example.com"
}

Respons

{
  "status": 200,
  "message": "Komentar dikirim untuk moderasi",
  "data": {
    "id": "f6a7b8c9-6666-7777-8888-999900001111",
    "post_id": "3f1a2b9c-7e4d-4c8a-9b21-0c5d6e7f8a90",
    "author_name": "Pembaca Tamu",
    "content": "Ini sangat membantu, terima kasih!",
    "status": "pending",
    "created_at": "2026-01-17T09:45:00Z",
    "parent_id": null,
    "replies": []
  }
}

Contoh cURL

curl -X POST "https://YOUR_HOST/v1/comments" \
  -H "Authorization: Bearer ***" \
  -H "X-Workspace-ID: YOUR_WORKSPACE_ID" \
  -H "Content-Type: application/json" \
  -d '{
    "post_id": "3f1a2b9c-7e4d-4c8a-9b21-0c5d6e7f8a90",
    "content": "Ini sangat membantu, terima kasih!",
    "name": "Pembaca Tamu",
    "email": "tamu@example.com"
  }'

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.