Arsitektur Dokumentasi

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

TULIS CMS/DEVELOPER HUB

/api-reference-post-get-post

Detail Posting

Melihat detail satu posting yang sudah dipublikasikan berdasarkan slug atau ID dari API publik.

Endpoint

GET /v1/posts/{slugOrId}

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
`slugOrId`	string \| UUID	Slug posting (string) atau ID posting (UUID).

Respons

{
  "status": 200,
  "message": "Posting berhasil diambil",
  "data": {
    "id": "3f1a2b9c-7e4d-4c8a-9b21-0c5d6e7f8a90",
    "title": "Memulai dengan Tulis",
    "slug": "memulai-dengan-tulis",
    "content": "<p>Selamat datang di Tulis, headless CMS Anda...</p>",
    "excerpt": "Pengenalan singkat membangun dengan Tulis.",
    "status": "published",
    "post_type": "article",
    "language": "id",
    "published_at": "2026-01-15T08:30:00Z",
    "feature_image": "https://cdn.tulis.app/media/cover-123.jpg",
    "seo_title": "Memulai dengan Tulis | Dokumen Tulis",
    "seo_desc": "Pelajari cara mengatur dan menggunakan Tulis sebagai headless CMS Anda.",
    "reading_time": 4,
    "taxonomies": [
      { "id": "a1b2c3d4-1111-2222-3333-444455556666", "name": "Panduan", "slug": "panduan", "type": "category" }
    ],
    "author": {
      "id": "c3d4e5f6-3333-4444-5555-666677778888",
      "name": "Ahmad Fulan",
      "avatar": "https://cdn.tulis.app/media/avatar-ahmad.jpg"
    }
  },
  "json_ld": {
    "@context": "https://schema.org",
    "@type": "BlogPosting",
    "headline": "Memulai dengan Tulis",
    "description": "Pengenalan singkat membangun dengan Tulis.",
    "image": "https://cdn.tulis.app/media/cover-123.jpg",
    "datePublished": "2026-01-15T08:30:00Z",
    "dateModified": "2026-01-15T08:30:00Z",
    "author": { "@type": "Person", "name": "Ahmad Fulan" },
    "publisher": { "@type": "Organization", "name": "Tulis" },
    "mainEntityOfPage": "https://YOUR_HOST/memulai-dengan-tulis"
  }
}

json_ld berisi data terstruktur schema.org (JSON-LD) yang mendeskripsikan posting. Sematkan di blok <script type="application/ld+json"> halaman Anda untuk meningkatkan SEO dan memungkinkan hasil kaya di mesin pencari.

Contoh cURL

curl "https://YOUR_HOST/v1/posts/memulai-dengan-tulis" \
  -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.