Dokumentasi/API/API provider/GET /api/v1/categories

Pahami endpoint kategori layanan aktif.

Endpoint ini dipakai untuk filter direktori, pembacaan taksonomi publik, dan pembentukan halaman discovery yang bergantung pada kategori aktif.

Auth dan cakupan

  • Autentikasi: tidak perlu.
  • Route hanya mengembalikan kategori yang isActive=true.
  • Respons memisahkan kategori induk dan child category lewat properti children.
  • Meta yang tersedia saat ini adalah total dan rootCount.

Parameter

Route ini tidak memerlukan path parameter maupun query parameter.

GET /api/v1/categories

Field respons yang penting

  • Setiap kategori memuat id, slug, name, description, parentId, dan sortOrder.
  • Kategori induk muncul di level data[], sedangkan child category ditempatkan di properti children.
  • meta.total menghitung seluruh row kategori aktif, bukan hanya kategori induk.
  • meta.rootCount menghitung jumlah kategori induk yang tampil di root response.

Bentuk respons

{
  "data": [
    {
      "id": "cat-parent",
      "slug": "digital-infrastructure",
      "name": "Digital Infrastructure",
      "children": [
        {
          "id": "cat-child",
          "slug": "nextjs-development",
          "name": "Next.js Development"
        }
      ]
    }
  ],
  "meta": {
    "total": 12,
    "rootCount": 4
  }
}