Penggunaan API
Pelajari cara melacak penggunaan API Anda. Pahami grafik penggunaan, apa yang terhitung sebagai request, dan hubungan dengan kredit.
Gambaran Umum
Halaman Penggunaan API menyediakan visibilitas lengkap terhadap bagaimana Anda menggunakan Kode Pos API. Dashboard ini membantu Anda melacak permintaan API, memantau konsumsi kredit, dan memahami pola penggunaan dari waktu ke waktu.
Fitur Utama
• Grafik interaktif permintaan API selama 30 hari terakhir
• Total permintaan yang telah dilakukan
• Kredit yang telah dikonsumsi
Akses halaman ini melalui dashboard di /app/penggunaan untuk melihat ringkasan penggunaan akun Anda secara real-time.
Interpretasi Grafik Penggunaan
Grafik penggunaan adalah visualisasi utama yang menunjukkan aktivitas API Anda dari waktu ke waktu. Berikut adalah cara membaca dan memahami data yang ditampilkan:
Rentang Waktu
Grafik menampilkan data untuk 30 hari terakhir secara default. Setiap titik pada grafik mewakili satu hari kalender dengan zona waktu disesuaikan ke lokasi server (WIB/UTC+7).
Batang Grafik (Bars)
Setiap batang vertikal pada grafik mewakili jumlah permintaan API yang berhasil diproses pada hari tersebut. Tinggi batang sebanding dengan volume permintaan—semakin tinggi batang, semakin banyak permintaan yang dilakukan.
Tooltip Interaktif
Arahkan kursor atau sentuh salah satu batang untuk menampilkan tooltip yang berisi:
• Tanggal lengkap
• Jumlah permintaan pada hari tersebut
• Kredit yang dikonsumsi
Ringkasan Total
Di bawah grafik, Anda akan menemukan ringkasan yang menampilkan total kumulatif: jumlah keseluruhan permintaan dan total kredit yang dikonsumsi selama periode 30 hari. Gunakan angka ini untuk evaluasi cepat penggunaan API Anda.
Apa yang Terhitung sebagai Request
Tidak semua panggilan ke Kode Pos API mengonsumsi kredit. Hanya permintaan yang berhasil mengambil data yang dihitung dalam penggunaan Anda. Berikut rincian lengkap apa yang terhitung dan apa yang tidak:
| Metode/API | Dikenakan Biaya? | Keterangan |
|---|---|---|
REST API | Ya | Setiap permintaan data yang berhasil: provinsi, kota, kecamatan, kelurahan, pencarian |
GraphQL API | Ya | Setiap query yang berhasil dieksekusi |
MCP Server | Ya (terbatas) | Hanya permintaan tools/call — metode protokol seperti initialize, tools/list, dan ping gratis |
/rate-limit | Tidak | Endpoint publik untuk memeriksa limit rate |
/status | Tidak | Endpoint publik untuk memeriksa status layanan |
| Request gagal | Tidak | Permintaan yang menghasilkan error (4xx, 5xx) tidak mengenakan biaya |
Catatan Penting
Kredit hanya dikenakan ketika permintaan API berhasil mengambil dan mengembalikan data. Permintaan yang gagal karena autentikasi tidak valid, parameter yang salah, atau error server tidak akan memotong kredit Anda. Untuk MCP Server, hanya eksekusi tool yang dikenakan biaya—interaksi protokol dasar sepenuhnya gratis.
Lihat dokumentasi lengkap: REST API | GraphQL API | MCP Server
Hubungan Penggunaan & Penagihan
Sistem kredit Kode Pos API menghubungkan penggunaan API langsung dengan biaya Anda. Setiap request yang berhasil mengurangi saldo kredit Anda sesuai dengan kebijakan tarif yang berlaku.
Konversi Kredit
Setiap 1 request API yang berhasil = 1 kredit. Lihat halaman Harga & Paket untuk info paket kredit dan diskon volume.
Memeriksa Sisa Kredit
Untuk melihat sisa kredit Anda:
- Buka dashboard dan navigasi ke halaman /app/penggunaan
- Lihat ringkasan kredit di bagian atas halaman
- Grafik menunjukkan konsumsi kredit selama 30 hari terakhir
Kredit Menipis
Ketika kredit Anda mendekati habis, Anda akan menerima notifikasi melalui email. Untuk melanjutkan penggunaan API tanpa gangguan, segera lakukan pengisian ulang kredit sebelum saldo mencapai nol.
Kunjungi halaman Harga & Paket untuk informasi detail tentang paket kredit, diskon volume, dan opsi berlangganan.
Akses Data & Ekspor Penggunaan
Data penggunaan Anda dapat diakses langsung melalui dashboard Kode Pos API. Saat ini, kami belum menyediakan API publik untuk mengekspor data penggunaan secara programatis, tetapi Anda dapat melihat dan memantau penggunaan melalui antarmuka dashboard.
Melalui Dashboard
Akses halaman /app/penggunaan di dashboard untuk melihat grafik interaktif, ringkasan total, dan riwayat penggunaan 30 hari terakhir.
Apa yang Tersedia
Di halaman penggunaan dashboard, Anda dapat melihat:
• Grafik batang harian untuk 30 hari terakhir
• Total permintaan dan kredit yang dikonsumsi
• Tooltip detail saat hover pada setiap batang
• Sisa kredit dan status akun Anda
Rencana Mendatang
Kami sedang mengembangkan API publik untuk ekspor data penggunaan, yang akan memungkinkan Anda mengambil data penggunaan secara programatis dalam format JSON atau CSV. Pantau pembaruan di halaman rilis atau blog kami untuk pengumuman fitur ini.
Butuh akses data penggunaan untuk pelaporan atau integrasi? Hubungi tim support kami untuk solusi kustom.