Buat key
- Di aplikasi Money Tracker, buka Profil lalu pilih API key.
- Ketuk Buat key, beri nama, lalu centang apa saja yang boleh dilakukan.
- Salin API_KEY dan API_SECRET. Secret hanya ditampilkan sekali.
Setiap akun bisa punya satu key aktif. Untuk menggantinya, cabut key di layar yang sama lalu buat yang baru. Key yang dicabut langsung berhenti berfungsi.
Autentikasi
Kirim kedua nilai sebagai header di setiap permintaan. Jangan pernah menaruh secret di URL, halaman web, atau aplikasi yang bisa dibuka orang lain.
- X-Api-Key
- API_KEY milikmu. Diawali dengan mtu_.
- X-Api-Secret
- API_SECRET milikmu, 40 huruf dan angka.
curl "https://moneytracker.arizu.id/api/v1/transactions?month=2026-11&type=income" \
-H "X-Api-Key: mtu_YOUR_API_KEY" \
-H "X-Api-Secret: YOUR_API_SECRET"Izin
Key hanya mendapat izin yang kamu centang. Izin tulis sudah termasuk izin baca.
- transactions:read
- Membaca transaksi
- transactions:write
- Mencatat, mengubah, dan menghapus transaksi
- categories:read
- Membaca kategori
- categories:write
- Menambah dan menghapus kategori
- money_sources:read
- Membaca sumber dana beserta saldonya
- money_sources:write
- Menambah, mengubah, dan menghapus sumber dana
- profile:read
- Membaca nama akun, email, mata uang, bahasa, dan paket
Endpoint
Path ditulis relatif terhadap URL dasar. Nominal memakai mata uang akun.
Akun
-
GET
/api/v1/auth/meprofile:readProfil akun.
Transaksi
-
GET
/api/v1/transactionstransactions:readTransaksi, dari yang terbaru. Filter: month (2026-11), type (income atau expense), source_id, page, per_page (maksimal 100).
-
GET
/api/v1/transactions/{id}transactions:readSatu transaksi.
-
POST
/api/v1/transactionstransactions:writeCatat transaksi. Wajib: type, amount, occurred_on (2026-11-02). Opsional: category_id, payment_source_id, note (maksimal 255 karakter), client_ref.
-
PUT
/api/v1/transactions/{id}transactions:writeUbah transaksi. Kirim field yang sama seperti saat mencatat, tanpa client_ref.
-
DELETE
/api/v1/transactions/{id}transactions:writeHapus transaksi.
Kategori
-
GET
/api/v1/categoriescategories:readKategori pemasukan dan pengeluaran.
-
POST
/api/v1/categoriescategories:writeTambah kategori. Wajib: type, name. Opsional: icon, color (#RRGGBB), client_ref.
-
DELETE
/api/v1/categories/{id}categories:writeHapus kategori.
Sumber dana
-
GET
/api/v1/payment-sourcesmoney_sources:readSumber dana beserta saldonya.
-
POST
/api/v1/payment-sourcesmoney_sources:writeTambah sumber dana. Wajib: type (bank, card, ewallet, atau cash), holder_name. Opsional: bank_name, provider_name, card_type, card_last4, opening_balance, client_ref.
-
PUT
/api/v1/payment-sources/{id}money_sources:writeUbah sumber dana.
-
DELETE
/api/v1/payment-sources/{id}money_sources:writeHapus sumber dana.
Path lain selalu membalas 403 untuk API key, meskipun aplikasinya sendiri memakai path itu.
Contoh: mencatat penjualan
Aplikasi kasir bisa mencatat setiap penjualan sebagai pemasukan. Beri setiap penjualan client_ref sendiri, supaya pengiriman ulang setelah gangguan jaringan tidak mencatat penjualan dua kali.
curl -X POST "https://moneytracker.arizu.id/api/v1/transactions" \
-H "X-Api-Key: mtu_YOUR_API_KEY" \
-H "X-Api-Secret: YOUR_API_SECRET" \
-H "Content-Type: application/json" \
-d '{
"type": "income",
"amount": 125000,
"occurred_on": "2026-11-02",
"note": "Sale 1042",
"client_ref": "pos-sale-1042"
}'Balasannya berstatus 201 dan berisi id transaksi baru di data.id.
{
"data": {
"id": 58213,
"amount": "125000.00",
"currency": "IDR",
"original_amount": null,
"original_currency": null,
"fx_rate": null,
"fx_date": null
}
}client_ref berisi 8 sampai 64 huruf, angka, atau tanda hubung. Kalau akun sudah punya transaksi dengan client_ref yang sama, API mengembalikan transaksi itu dan tidak mencatat yang baru.
Respons dan error
Balasan yang berhasil menaruh hasilnya di data. Balasan yang gagal berisi pesan di error dalam bahasa akun, dan sering juga code yang sama di semua bahasa.
{
"error": "This API key does not have the permission for this request",
"code": "api_key_scope_missing",
"scope": "transactions:write"
}- 401
- Key atau secret tidak dikirim atau salah, atau key sudah dicabut atau kedaluwarsa.
- 403
- Key tidak punya izin untuk permintaan ini, path tersebut tertutup untuk API key, atau akunnya diblokir.
- 404
- Data tersebut tidak ada di akun ini.
- 422
- Ada field yang kosong atau tidak valid. Kalau ada fields, isinya daftar yang perlu diperbaiki.
- 429
- Terlalu banyak permintaan. Tunggu sesuai jumlah detik di header Retry-After.
Batas pemakaian
Setiap key bisa mengirim hingga 60 permintaan per menit. Batas paketmu tetap berlaku, sama seperti di aplikasi. Di paket Free, artinya maksimal 30 transaksi baru per hari.
Jaga keamanan key
- Simpan secret di satu tempat saja, misalnya di pengaturan aplikasi kasirmu, dan jangan bagikan lewat chat atau email.
- Centang hanya izin yang dibutuhkan sistem itu.
- Kalau secret bocor, cabut key itu di aplikasi lalu buat yang baru.
- Aplikasi menampilkan kapan key-mu terakhir dipakai. Kalau tidak cocok dengan sistem milikmu, cabut key itu.
Ada pertanyaan soal API? Tulis ke ariefzufar@arizu.id / arizu.team@gmail.com.