Dokumentasi Resmi
|tulis.org

Arsitektur Dokumentasi

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

TULIS CMS/DEVELOPER HUB
/sdks-curl-examples

API Publik Tulis — Contoh curl

Kumpulan panggilan curl mentah untuk operasi paling umum terhadap API publik Tulis headless CMS.

Peringatan keamanan: Jangan pernah mengekspos kunci API Anda di kode sisi klien atau browser. Header Authorization: Bearer hanya boleh dikirim dari server tepercaya. Siapa pun dengan kunci API Anda dapat membaca konten workspace Anda.

Semua permintaan memerlukan dua header:

  • Authorization: Bearer *** — kunci API publik Anda
  • X-Workspace-ID: YOUR_WORKSPACE_ID — workspace target

Ganti YOUR_API_KEY, YOUR_WORKSPACE_ID, dan YOUR_HOST dengan nilai asli Anda. Path dasar publik adalah /v1.

Lihat daftar posting

curl "https://YOUR_HOST/v1/posts?page=1&per_page=10" \
  -H "Authorization: Bearer ***" \
  -H "X-Workspace-ID: YOUR_WORKSPACE_ID"

Detail posting berdasarkan slug (atau ID)

curl "https://YOUR_HOST/v1/posts/my-post-slug" \
  -H "Authorization: Bearer ***" \
  -H "X-Workspace-ID: YOUR_WORKSPACE_ID"

Lihat daftar kategori

curl "https://YOUR_HOST/v1/taxonomies?type=category" \
  -H "Authorization: Bearer ***" \
  -H "X-Workspace-ID: YOUR_WORKSPACE_ID"

Lihat daftar tag

curl "https://YOUR_HOST/v1/taxonomies?type=tag" \
  -H "Authorization: Bearer ***" \
  -H "X-Workspace-ID: YOUR_WORKSPACE_ID"

Lihat daftar media

curl "https://YOUR_HOST/v1/media" \
  -H "Authorization: Bearer ***" \
  -H "X-Workspace-ID: YOUR_WORKSPACE_ID"

Lihat daftar komentar (disetujui) untuk sebuah posting

curl "https://YOUR_HOST/v1/posts/POST_ID/comments" \
  -H "Authorization: Bearer ***" \
  -H "X-Workspace-ID: YOUR_WORKSPACE_ID"

Buat komentar

Komentar tamu memerlukan name, email, post_id, dan content. Komentar baru dibuat dengan status pending dan harus disetujui sebelum muncul secara publik.

curl "https://YOUR_HOST/v1/comments" \
  -H "Authorization: Bearer ***" \
  -H "X-Workspace-ID: YOUR_WORKSPACE_ID" \
  -H "Content-Type: application/json" \
  -d '{
    "name": "Ahmad Fulan",
    "email": "ahmad@example.com",
    "post_id": "POST_ID",
    "content": "Artikel yang bagus, terima kasih sudah berbagi!"
  }'

Lihat sitemap

curl "https://YOUR_HOST/v1/workspaces/YOUR_WORKSPACE_ID/sitemap" \
  -H "Authorization: Bearer ***" \
  -H "X-Workspace-ID: YOUR_WORKSPACE_ID"

Lihat gambar OG

curl "https://YOUR_HOST/v1/og-image/POST_ID" \
  -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.