REST API

Masukkan data NowMetrix ke alat yang sudah digunakan tim Anda.

Mulai dengan snapshot live, buat tampilan ruang redaksi, atau kirim hasil historis ke alur kerja pelaporan Anda. Pilih endpoint di sini, lalu buka referensi teknis lengkapnya.

Hubungkan aplikasi Anda

Baru menggunakan API? Mulai dengan panduan koneksi lengkap. Panduan ini menjelaskan cara membuat dan melindungi API key, memverifikasinya dengan /api/me, serta membuat permintaan terautentikasi yang sama dari bahasa pemrograman umum.

Buka panduan koneksi

Mulai dengan satu URL dasar

Setiap permintaan yang diautentikasi dengan API key dimulai dari host ini:

https://api.nowmetrix.com

Kirim API key Anda

Kirim API key sebagai token Bearer di header Authorization. Admin akun dan anggota tim dengan akses API dapat membuat dan memberi label hingga 10 key aktif di dasbor NowMetrix melalui Pengaturan -> API.

Authorization: Bearer nm_YOUR_KEY

HTTPS wajib digunakan. Semua key menggunakan izin pengguna NowMetrix terkait dan berbagi batas laju masing-masing tracker.

Buat permintaan pertama Anda

Cara tercepat untuk menguji penyiapan Anda adalah dengan snapshot realtime. Snapshot ini memastikan key berfungsi dan dapat mengakses tracker.

curl -H "Authorization: Bearer nm_YOUR_KEY" \
  "https://api.nowmetrix.com/v1/realtime?site=TRACKER_ID"

Pilih data yang Anda perlukan

Metode	Path	Deskripsi	Referensi
GET	`/v1/realtime`	Snapshot live saat ini: pengguna aktif, pageviews, halaman teratas, perangkat, negara, kota, dan sumber.	Lihat endpoint
GET	`/v1/sources`	Sumber traffic dari jendela live saat ini, lengkap dengan klasifikasi dan baris turunan opsional.	Lihat endpoint
GET	`/v1/overview`	Pageviews dan kunjungan harian untuk N entri riwayat terakhir yang telah selesai.	Lihat endpoint
GET	`/v1/recap`	Data Recap, metrik ringkasan, dan halaman teratas untuk preset atau rentang tanggal kustom.	Lihat endpoint
GET	`/v1/pulse`	Data Pulse hari ini, perbandingan dengan kemarin, dan kurva intrahari dengan interval 15 menit.	Lihat endpoint
GET	`/v1/proofreading`	Hingga 100 saran pemeriksaan teks yang saat ini tersedia, dari artikel yang paling baru diperiksa pada satu tracker.	Lihat endpoint
GET	`/v1/responsibilities`	Tanggung jawab tim saat ini untuk sebuah tracker, termasuk orang yang ditugaskan ke setiap peran yang tersedia.	Lihat endpoint
GET	`/api/me`	Konteks akun API key: tracker saat ini dan semua tracker yang dapat diakses token.	Lihat endpoint

Jaga permintaan tetap cepat dan konsisten

API publik mengizinkan 20 permintaan per menit untuk setiap tracker. Beberapa pengguna atau key yang meminta data dari tracker yang sama akan berbagi penghitung yang sama.

X-RateLimit-Limit: 20
X-RateLimit-Remaining: 7
X-RateLimit-Reset: 1783612801
Retry-After: 42

Simpan respons API dalam cache di sistem Anda sendiri jika memungkinkan. Sebagai aturan praktis, simpan data realtime dalam cache untuk waktu singkat dan data ringkasan historis selama beberapa menit.

Saat permintaan gagal

Anda tidak perlu mengurai format yang berbeda untuk setiap masalah. Kesalahan API menggunakan isi JSON yang konsisten dengan kode stabil yang dapat dibaca mesin.

HTTP	Kode	Deskripsi
400	`site_required`	Parameter site yang wajib diisi tidak ada.
401	`missing_token`	Header Authorization tidak ada.
401	`invalid_token`	Token tidak valid atau telah dicabut.
403	`site_not_authorized`	API key tidak memiliki akses ke tracker ini.
429	`rate_limit_exceeded`	Batas laju telah terlampaui.
503	`redis_unavailable`	Backend realtime untuk sementara tidak tersedia.

{
  "error": {
    "code": "invalid_token",
    "message": "Bearer token is invalid or revoked."
  }
}