API für Entwickler

Lies und erfasse Transaktionen, Kategorien und Geldquellen deines eigenen Money Tracker-Kontos aus einem anderen System, etwa einer Kassensoftware oder einem Skript. Ein Schlüssel erreicht nur die Daten des Kontos, das ihn erstellt hat.

Basis-URL
https://moneytracker.arizu.id
Authentifizierung
X-Api-Key
X-Api-Secret
Format
JSON über HTTPS
Limits
60 Anfragen pro Minute je Schlüssel

Schlüssel erstellen

  1. Öffne in der Money Tracker-App dein Profil und wähle API-Schlüssel.
  2. Tippe auf Schlüssel erstellen, gib ihm einen Namen und hake an, was er darf.
  3. Kopiere API_KEY und API_SECRET. Das Secret wird nur einmal angezeigt.

Jedes Konto kann einen aktiven Schlüssel haben. Um ihn zu ersetzen, widerrufe ihn auf demselben Bildschirm und erstelle einen neuen. Ein widerrufener Schlüssel funktioniert sofort nicht mehr.

Authentifizierung

Sende beide Werte bei jeder Anfrage als Header. Setze das Secret nie in eine URL, eine Webseite oder eine App, die andere öffnen können.

X-Api-Key
Dein API_KEY. Er beginnt mit mtu_.
X-Api-Secret
Dein API_SECRET, 40 Buchstaben und Ziffern.
Anfrage
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"

Berechtigungen

Ein Schlüssel bekommt nur die Berechtigungen, die du anhakst. Eine Schreibberechtigung schließt Lesen ein.

transactions:read
Transaktionen lesen
transactions:write
Transaktionen erfassen, ändern und löschen
categories:read
Kategorien lesen
categories:write
Kategorien hinzufügen und löschen
money_sources:read
Geldquellen und ihre Salden lesen
money_sources:write
Geldquellen hinzufügen, ändern und löschen
profile:read
Name, E-Mail, Währung, Sprache und Tarif des Kontos lesen

Endpunkte

Pfade sind relativ zur Basis-URL. Beträge sind in der Kontowährung.

Konto

  • GET/api/v1/auth/meprofile:read

    Das Kontoprofil.

Transaktionen

  • GET/api/v1/transactionstransactions:read

    Transaktionen, neueste zuerst. Filter: month (2026-11), type (income oder expense), source_id, page, per_page (bis 100).

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

    Eine Transaktion.

  • POST/api/v1/transactionstransactions:write

    Erfasst eine Transaktion. Pflicht: type, amount, occurred_on (2026-11-02). Optional: category_id, payment_source_id, note (bis 255 Zeichen), client_ref.

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

    Ändert eine Transaktion. Sende dieselben Felder wie beim Erfassen, ohne client_ref.

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

    Löscht eine Transaktion.

Kategorien

  • GET/api/v1/categoriescategories:read

    Einnahme- und Ausgabekategorien.

  • POST/api/v1/categoriescategories:write

    Fügt eine Kategorie hinzu. Pflicht: type, name. Optional: icon, color (#RRGGBB), client_ref.

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

    Löscht eine Kategorie.

Geldquellen

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

    Geldquellen mit ihren Salden.

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

    Fügt eine Geldquelle hinzu. Pflicht: type (bank, card, ewallet oder cash), holder_name. Optional: bank_name, provider_name, card_type, card_last4, opening_balance, client_ref.

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

    Ändert eine Geldquelle.

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

    Löscht eine Geldquelle.

Jeder andere Pfad antwortet einem API-Schlüssel mit 403, auch wenn die App ihn selbst nutzt.

Beispiel: einen Verkauf erfassen

Eine Kassensoftware kann jeden Verkauf als Einnahme erfassen. Gib jedem Verkauf eine eigene client_ref, damit ein erneuter Versuch nach einem Netzwerkfehler den Verkauf nicht doppelt erfasst.

Anfrage
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"
  }'

Die Antwort hat den Status 201 und enthält die ID der neuen Transaktion in data.id.

Antwort 201
{
  "data": {
    "id": 58213,
    "amount": "125000.00",
    "currency": "IDR",
    "original_amount": null,
    "original_currency": null,
    "fx_rate": null,
    "fx_date": null
  }
}

client_ref besteht aus 8 bis 64 Buchstaben, Ziffern oder Bindestrichen. Hat das Konto schon eine Transaktion mit derselben client_ref, gibt die API diese zurück, statt eine neue zu erfassen.

Antworten und Fehler

Eine erfolgreiche Antwort enthält das Ergebnis in data. Eine fehlgeschlagene Antwort enthält eine Meldung in error, in der Sprache des Kontos, und oft einen code, der in jeder Sprache gleich ist.

Antwort 403
{
  "error": "This API key does not have the permission for this request",
  "code": "api_key_scope_missing",
  "scope": "transactions:write"
}
401
Schlüssel oder Secret fehlt oder ist falsch, oder der Schlüssel wurde widerrufen oder ist abgelaufen.
403
Der Schlüssel hat keine Berechtigung für diese Anfrage, der Pfad ist für API-Schlüssel gesperrt oder das Konto ist blockiert.
404
Der Eintrag existiert in diesem Konto nicht.
422
Ein Feld fehlt oder ist ungültig. Wenn fields vorhanden ist, steht dort, was zu korrigieren ist.
429
Zu viele Anfragen. Warte so viele Sekunden, wie der Header Retry-After angibt.

Limits

Jeder Schlüssel kann bis zu 60 Anfragen pro Minute senden. Die Limits deines Tarifs gelten weiterhin, genau wie in der App. Im Free-Tarif sind das bis zu 30 neue Transaktionen pro Tag.

Schütze deine Schlüssel

  • Bewahre das Secret an einem einzigen Ort auf, etwa in den Einstellungen deiner Kassensoftware, und teile es nicht per Chat oder E-Mail.
  • Hake nur die Berechtigungen an, die das System braucht.
  • Wenn ein Secret bekannt wird, widerrufe den Schlüssel in der App und erstelle einen neuen.
  • Die App zeigt, wann dein Schlüssel zuletzt benutzt wurde. Passt das nicht zu deinen eigenen Systemen, widerrufe den Schlüssel.

Fragen zur API? Schreibe an ariefzufar@arizu.id / arizu.team@gmail.com.