Arsitektur Dokumentasi

Endpoint ADMIN untuk melihat analitik workspace terbatas guna membangun dashboard sendiri.

Endpoint

• days — (param kueri, opsional) jumlah hari ke belakang. Bawaan: 30.

Autentikasi

Ini adalah endpoint ADMIN / workspace terautentikasi — ini TIDAK menggunakan kunci API publik.

• Authorization: Bearer *** — JWT yang diterbitkan untuk pengguna workspace yang terautentikasi
• X-Workspace-ID: <workspace_id> — membatasi hasil ke satu workspace

🔒 Khusus admin. Kunci API publik (digunakan oleh POST /v1/analytics/view/:id) tidak dapat mengakses endpoint ini. Gunakan JWT pengguna asli.

Respons

{
  "total_views": 12453,
  "views_by_day": [
    { "date": "2026-06-19", "views": 412 },
    { "date": "2026-06-20", "views": 388 }
  ],
  "top_posts": [
    { "post_id": "9f1c2b3a-4d5e-6f70-8192-a3b4c5d6e7f8", "title": "Posting Pertama Saya", "views": 1024 },
    { "post_id": "1a2b3c4d-5e6f-7081-9203-a4b5c6d7e8f9", "title": "Bacaan Menarik Lainnya", "views": 873 }
  ],
  "top_referrers": [
    { "referrer": "https://news.ycombinator.com", "views": 540 },
    { "referrer": "https://twitter.com", "views": 311 }
  ]
}

• total_views — total tampilan dalam jendela waktu.
• views_by_day — jumlah tampilan per hari (date dalam YYYY-MM-DD).
• top_posts — 10 posting teratas berdasarkan tampilan (post_id, title, views).
• top_referrers — 5 pengarah teratas berdasarkan tampilan (referrer, views).

Kasus Penggunaan

Bangun dashboard analitik di dalam panel admin atau aplikasi Anda sendiri. Data terbatas workspace — hanya tampilan milik workspace di X-Workspace-ID yang dikembalikan.

Contoh cURL (Admin)

curl -X GET "https://YOUR_HOST/api/analytics?days=30" \
  -H "Authorization: Bearer ***" \
  -H "X-Workspace-ID: YOUR_WORKSPACE_ID"

Contoh Klien (Aplikasi Admin)

const res = await fetch(`https://YOUR_HOST/api/analytics?days=30`, {
  headers: {
    "Authorization": `Bearer ${adminJwt}`, // JWT sesi pengguna, BUKAN kunci API publik
    "X-Workspace-ID": workspaceId,
  },
});

const data = await res.json();
// data.total_views, data.views_by_day, data.top_posts, data.top_referrers