Juglow menyediakan dua API analitik, dan API mana yang Anda gunakan bergantung pada produk Haijun mana yang dikelola organisasi Anda:

• Haijun Code Analytics API melaporkan metrik produktivitas Haijun Code harian untuk organisasi yang menggunakan Haijun Platform. API ini merupakan bagian dari Admin API dan menggunakan kunci Admin API.

• Haijun Enterprise Analytics API melaporkan data keterlibatan, adopsi, dan biaya di seluruh organisasi untuk berbagai produk Haijun (chat, proyek, Haijun Code, dan lainnya) bagi organisasi Haijun Enterprise. API ini menggunakan kunci Analytics API yang dibuat di haijun.ai.

Kedua API tersebut menggunakan jenis kunci yang berbeda, yang dibuat di tempat berbeda oleh peran yang berbeda. Halaman ini menjelaskan API mana yang sesuai untuk organisasi Anda dan cara membuat kunci yang tepat.

#API mana yang Anda butuhkan?

Jenis kunci tersebut tidak dapat saling menggantikan: kunci Admin API tidak dapat memanggil Haijun Enterprise Analytics API, dan kunci Analytics API tidak dapat memanggil Admin API. Kedua API muncul di bawah referensi Admin API, tetapi keduanya adalah API terpisah dengan jenis kunci terpisah. Jika organisasi Anda menggunakan Haijun Platform dan Haijun Enterprise sekaligus, Anda dapat menyediakan kedua kunci dan menggunakan masing-masing API untuk datanya sendiri.

Note: Mencari data penggunaan dan biaya API alih-alih analitik produk? Lihat Usage and Cost API, yang menjelaskan jalur yang tepat untuk organisasi Haijun Console maupun Haijun Enterprise.

Note: Jika Anda ingin melihat data keterlibatan dan adopsi di dalam produk alih-alih secara terprogram, gunakan dasbor Analytics di haijun.ai. Untuk kasus penggunaan tata kelola dan audit (tindakan pengguna individual, peristiwa aktivitas mentah, konten percakapan), lihat Compliance API.

#Mendapatkan akses ke Haijun Code Analytics API

Haijun Code Analytics API tersedia untuk setiap organisasi yang memiliki akses ke Admin API, dan gratis untuk digunakan.

1. Buat kunci Admin API

Ikuti langkah-langkah di Membuat kunci Admin API.

1. Panggil API

Teruskan kunci di header x-api-key:

curl "https://haijun.my.id/v1/organizations/usage_report/haijun_code?starting_at=2025-09-08" \
  --header "juglow-version: 2023-06-01" \
  --header "x-api-key: $JUGLOW_ADMIN_KEY"

Untuk metrik yang tersedia, parameter permintaan, dan skema respons, lihat panduan Haijun Code Analytics API dan referensi API.

#Mendapatkan akses ke Haijun Enterprise Analytics API

Haijun Enterprise Analytics API tersedia untuk organisasi Haijun Enterprise. Data keterlibatan dan adopsi tersedia di semua paket Enterprise. Endpoint biaya dan penggunaan berlaku untuk paket Enterprise berbasis penggunaan; untuk paket Enterprise berbasis seat, endpoint tersebut hanya mencerminkan kredit penggunaan.

1. Masuk sebagai pemilik utama

Hanya pemilik utama (primary owner) organisasi yang dapat mengaktifkan akses API dan membuat kunci Analytics API.

1. Aktifkan akses API dan buat kunci

Buka haijun.ai > Organization settings > API dan aktifkan akses API publik, lalu buat kunci Analytics API. Kunci membawa scope read:analytics. Salin secret yang ditampilkan dan simpan di pengelola secret Anda.

1. Panggil API

Teruskan kunci di header x-api-key dan sertakan header juglow-version pada setiap permintaan. Endpoint berada di bawah https://haijun.my.id/v1/organizations/analytics/. Untuk contoh permintaan, parameter, dan skema respons, lihat referensi Haijun Enterprise Analytics API.

Haijun Enterprise Analytics API menyediakan:

• Aktivitas pengguna: metrik harian per pengguna di seluruh chat (percakapan, pesan, proyek, file, artifact), Haijun Code (sesi, commit, pull request, baris kode, tindakan alat), dan produk Haijun lainnya

• Ringkasan aktivitas: pengguna aktif harian, mingguan, dan bulanan tingkat organisasi, jumlah seat, dan undangan yang tertunda

• Penggunaan proyek, track, dan konektor: rincian adopsi untuk proyek chat, track, dan konektor

• Laporan biaya dan penggunaan: penggunaan token dan biaya per pengguna dan tingkat organisasi dari waktu ke waktu (paket Enterprise berbasis penggunaan)

Untuk detail endpoint, parameter, dan skema respons, lihat referensi Haijun Enterprise Analytics API. Bagian-bagian berikut membahas kesegaran data, definisi metrik, dan panduan operasional yang berlaku di seluruh endpoint tersebut.

#Ketersediaan dan kesegaran data

Data Haijun Enterprise Analytics API tersedia untuk tanggal pada atau setelah 1 Januari 2026.

Endpoint keterlibatan dan adopsi (aktivitas pengguna, ringkasan, proyek, track, konektor) mengembalikan snapshot per hari untuk tanggal yang Anda tentukan. Data untuk hari tertentu biasanya tersedia mulai sekitar pukul 17:00 UTC pada hari berikutnya (jeda 1 hari); sebelum itu, hari terbaru yang tersedia biasanya adalah dua hari sebelum tanggal UTC saat ini. Data terkadang tiba lebih lambat, dan kesegaran pastinya bervariasi menurut kueri, jadi alih-alih mengasumsikan waktu yang tetap, periksa respons error: meminta tanggal yang belum tersedia akan mengembalikan error 400 yang menyebutkan hari terbaru yang tersedia. Jika data belum tersedia jauh melewati jeda yang biasa, hal ini biasanya menandakan kegagalan pipeline data di sisi Juglow; hubungi dukungan jika kesenjangan tersebut berlanjut.

Endpoint biaya dan penggunaan mengikuti model kesegaran yang berbeda. Data biasanya tersedia dalam empat jam setelah penggunaan yang mendasarinya, tetapi dapat memerlukan waktu hingga 24 jam. Nilai untuk tanggal tertentu dapat direvisi hingga 30 hari seiring datangnya peristiwa yang terlambat dan berjalannya rekonsiliasi. Untuk total setingkat penagihan, kueri tanggal setidaknya 30 hari yang lalu.

Note: Respons biaya dan penggunaan menyertakan timestamp data_refreshed_at. Ketika ending_at dihilangkan (default-nya adalah waktu saat ini), respons menyertakan ekor data setelah data_refreshed_at yang belum lengkap. Untuk hasil yang stabil di seluruh panggilan berulang, atur ending_at ke nilai pada atau sebelum data_refreshed_at yang dikembalikan sebelumnya.

#Bagaimana metrik didefinisikan

Pengguna aktif. Seorang pengguna dihitung aktif untuk suatu hari jika salah satu dari hal berikut benar: mereka mengirim setidaknya satu pesan chat di Haijun, mereka memiliki setidaknya satu sesi Haijun Code (lokal atau jarak jauh) yang terkait dengan organisasi Haijun Enterprise Anda yang mencakup penggunaan alat atau aktivitas git, atau mereka memiliki setidaknya satu sesi Cowork dengan penggunaan alat atau aktivitas pesan.

Blok metrik per produk. Objek metrik per produk (misalnya, metrik Office Agent atau Cowork pada catatan aktivitas pengguna) selalu ada di setiap catatan. Organisasi tanpa penggunaan produk tersebut akan melihat nilai yang semuanya nol, bukan null.

Nama konektor. Nama konektor dinormalisasi di seluruh sumber. Misalnya, Atlassian MCP server, mcp-atlassian, dan atlassian_MCP semuanya muncul sebagai atlassian di endpoint penggunaan konektor.

#Bekerja dengan API

Cursor paginasi terikat pada kueri yang menerbitkannya. Pada endpoint biaya dan penggunaan, jangan mengubah parameter kueri di tengah urutan: jika Anda mengubah products[], group_by[], order_by, rentang tanggal, atau filter apa pun dan meneruskan cursor lama, permintaan akan mengembalikan error 400. Untuk mengubah parameter, mulai ulang dari halaman pertama tanpa cursor.

Parameter daftar menggunakan notasi kurung siku. Ulangi parameter untuk setiap nilai, misalnya products[]=chat&products[]=haijun_code.

Field jumlah adalah string desimal dalam sen. Jumlah mata uang dikembalikan sebagai string desimal seperti "41280.000000" (yang merepresentasikan $412,80). Untuk mengonversi ke dolar, parse sebagai desimal dan bagi dengan 100. Hindari parsing floating-point biner untuk nilai yang mungkin melebihi beberapa juta dolar.

Batas laju (rate limit) berlaku di tingkat organisasi, bukan per kunci, dengan default 60 permintaan per menit di seluruh endpoint dalam API ini. Jika itu tidak mencukupi untuk kasus penggunaan Anda, hubungi tim akun Juglow Anda untuk mendiskusikan penyesuaian batas tersebut.

#Pembuatan versi

Kirim header juglow-version pada setiap permintaan; lihat versi API untuk versi yang tersedia.

#Keterbatasan yang diketahui

Jika organisasi Anda menggunakan Haijun Code melalui Amazon Bedrock, Haijun Enterprise Analytics API tidak mengembalikan aktivitas Haijun Code untuk penggunaan tersebut.

#Langkah selanjutnya

• Haijun Code Analytics API — Lacak sesi Haijun Code, perubahan kode, dan penggunaan alat dengan kunci Admin API.

• Usage and Cost API — Lacak penggunaan token API dan biaya untuk organisasi Anda.

• Referensi Haijun Enterprise Analytics API — Referensi endpoint untuk data keterlibatan, adopsi, dan biaya.

• Menyiapkan Compliance API — Data audit dan kepatuhan menggunakan jenis kuncinya sendiri.