Schlüssel erstellen
- Öffne in der Money Tracker-App dein Profil und wähle API-Schlüssel.
- Tippe auf Schlüssel erstellen, gib ihm einen Namen und hake an, was er darf.
- 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.
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:readDas Kontoprofil.
Transaktionen
-
GET
/api/v1/transactionstransactions:readTransaktionen, neueste zuerst. Filter: month (2026-11), type (income oder expense), source_id, page, per_page (bis 100).
-
GET
/api/v1/transactions/{id}transactions:readEine Transaktion.
-
POST
/api/v1/transactionstransactions:writeErfasst 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:writeLöscht eine Transaktion.
Kategorien
-
GET
/api/v1/categoriescategories:readEinnahme- und Ausgabekategorien.
-
POST
/api/v1/categoriescategories:writeFügt eine Kategorie hinzu. Pflicht: type, name. Optional: icon, color (#RRGGBB), client_ref.
-
DELETE
/api/v1/categories/{id}categories:writeLöscht eine Kategorie.
Geldquellen
-
GET
/api/v1/payment-sourcesmoney_sources:readGeldquellen mit ihren Salden.
-
POST
/api/v1/payment-sourcesmoney_sources:writeFü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:writeLö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.
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.
{
"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.
{
"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.