Arsitektur Dokumentasi

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

TULIS CMS/DEVELOPER HUB

/guides-filter-by-taxonomy

Memfilter Posting berdasarkan Taksonomi (Kategori / Tag)

Tulis mengatur posting menggunakan taksonomi — kategori dan tag. Panduan ini menunjukkan cara membangun navigasi kategori/tag dan memfilter posting berdasarkan taksonomi yang dipilih.

1. Lihat taksonomi yang tersedia

Melihat daftar kategori (atau tag) yang tersedia di workspace Anda. Gunakan GET /v1/taxonomies dengan parameter kueri type:

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

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

Setiap taksonomi memiliki slug yang akan Anda gunakan untuk memfilter posting.

2. Bangun navigasi kategori

Render taksonomi yang dikembalikan sebagai tautan. Pola umum memetakan setiap kategori ke URL di situs Anda:

const res = await fetch(
  "https://YOUR_HOST/v1/taxonomies?type=category",
  {
    headers: {
      Authorization: "Bearer <API_KEY>",
      "X-Workspace-ID": "<WORKSPACE_ID>",
    },
  }
);
const { data } = await res.json();

const nav = data
  .map((tax) => `<li><a href="/category/${tax.slug}">${tax.name}</a></li>`)
  .join("");
document.getElementById("categories").innerHTML = `<ul>${nav}</ul>`;

3. Filter posting berdasarkan taksonomi

Ketika pengunjung membuka /category/<slug>, panggil endpoint posting dengan parameter kueri taxonomy yang diatur ke slug tersebut:

curl "https://YOUR_HOST/v1/posts?taxonomy=news" \
  -H "Authorization: Bearer ***" \
  -H "X-Workspace-ID: <WORKSPACE_ID>"

const slug = "news"; // dari /category/news
const res = await fetch(
  `https://YOUR_HOST/v1/posts?taxonomy=${slug}`,
  {
    headers: {
      Authorization: "Bearer <API_KEY>",
      "X-Workspace-ID": "<WORKSPACE_ID>",
    },
  }
);
const { data } = await res.json();
// render data sebagai daftar posting (lihat build-a-blog.md)

Parameter taxonomy yang sama berfungsi untuk tag — cukup gunakan slug tag tersebut.

Ringkasan

GET /v1/taxonomies?type=category|tag melihat daftar taksonomi yang tersedia.
GET /v1/posts?taxonomy=<slug> memfilter posting berdasarkan istilah tersebut.
Petakan /category/<slug> (atau /tag/<slug>) di situs Anda ke panggilan posting yang difilter.

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.