API untuk developer

Baca dan catat transaksi, kategori, serta sumber dana di akun Money Tracker milikmu dari sistem lain, misalnya aplikasi kasir atau skrip. Satu key hanya bisa mengakses data akun yang membuatnya.

URL dasar
https://moneytracker.arizu.id
Autentikasi
X-Api-Key
X-Api-Secret
Format
JSON lewat HTTPS
Batas pemakaian
60 permintaan per menit per key

Buat key

  1. Di aplikasi Money Tracker, buka Profil lalu pilih API key.
  2. Ketuk Buat key, beri nama, lalu centang apa saja yang boleh dilakukan.
  3. 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.
Permintaan
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:read

    Profil akun.

Transaksi

  • GET/api/v1/transactionstransactions:read

    Transaksi, dari yang terbaru. Filter: month (2026-11), type (income atau expense), source_id, page, per_page (maksimal 100).

  • GET/api/v1/transactions/{id}transactions:read

    Satu transaksi.

  • POST/api/v1/transactionstransactions:write

    Catat 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:write

    Ubah transaksi. Kirim field yang sama seperti saat mencatat, tanpa client_ref.

  • DELETE/api/v1/transactions/{id}transactions:write

    Hapus transaksi.

Kategori

  • GET/api/v1/categoriescategories:read

    Kategori pemasukan dan pengeluaran.

  • POST/api/v1/categoriescategories:write

    Tambah kategori. Wajib: type, name. Opsional: icon, color (#RRGGBB), client_ref.

  • DELETE/api/v1/categories/{id}categories:write

    Hapus kategori.

Sumber dana

  • GET/api/v1/payment-sourcesmoney_sources:read

    Sumber dana beserta saldonya.

  • POST/api/v1/payment-sourcesmoney_sources:write

    Tambah 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:write

    Ubah sumber dana.

  • DELETE/api/v1/payment-sources/{id}money_sources:write

    Hapus 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.

Permintaan
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.

Balasan 201
{
  "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.

Balasan 403
{
  "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.