API pour les développeurs

Lisez et enregistrez les transactions, catégories et sources d'argent de votre propre compte Money Tracker depuis un autre système, comme une caisse ou un script. Une clé n'accède qu'aux données du compte qui l'a créée.

URL de base
https://moneytracker.arizu.id
Authentification
X-Api-Key
X-Api-Secret
Format
JSON via HTTPS
Limites
60 requêtes par minute par clé

Obtenir une clé

  1. Dans l'app Money Tracker, ouvrez Profil puis choisissez Clés API.
  2. Touchez Créer une clé, donnez-lui un nom et cochez ce qu'elle peut faire.
  3. Copiez l'API_KEY et l'API_SECRET. Le secret ne s'affiche qu'une seule fois.

Chaque compte peut avoir une clé active. Pour la remplacer, révoquez-la sur le même écran et créez-en une nouvelle. Une clé révoquée cesse de fonctionner aussitôt.

Authentification

Envoyez les deux valeurs en en-têtes à chaque requête. Ne mettez jamais le secret dans une URL, une page web ou une app que d'autres personnes peuvent ouvrir.

X-Api-Key
Votre API_KEY. Elle commence par mtu_.
X-Api-Secret
Votre API_SECRET, 40 lettres et chiffres.
Requête
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"

Autorisations

Une clé n'obtient que les autorisations que vous cochez. Une autorisation d'écriture inclut la lecture.

transactions:read
Lire les transactions
transactions:write
Enregistrer, modifier et supprimer des transactions
categories:read
Lire les catégories
categories:write
Ajouter et supprimer des catégories
money_sources:read
Lire les sources d'argent et leurs soldes
money_sources:write
Ajouter, modifier et supprimer des sources d'argent
profile:read
Lire le nom, l'e-mail, la devise, la langue et l'offre du compte

Endpoints

Les chemins sont relatifs à l'URL de base. Les montants sont dans la devise du compte.

Compte

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

    Le profil du compte.

Transactions

  • GET/api/v1/transactionstransactions:read

    Les transactions, les plus récentes d'abord. Filtres : month (2026-11), type (income ou expense), source_id, page, per_page (jusqu'à 100).

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

    Une transaction.

  • POST/api/v1/transactionstransactions:write

    Enregistre une transaction. Obligatoires : type, amount, occurred_on (2026-11-02). Facultatifs : category_id, payment_source_id, note (255 caractères au maximum), client_ref.

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

    Modifie une transaction. Envoyez les mêmes champs que pour l'enregistrer, sans client_ref.

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

    Supprime une transaction.

Catégories

  • GET/api/v1/categoriescategories:read

    Les catégories de revenus et de dépenses.

  • POST/api/v1/categoriescategories:write

    Ajoute une catégorie. Obligatoires : type, name. Facultatifs : icon, color (#RRGGBB), client_ref.

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

    Supprime une catégorie.

Sources d'argent

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

    Les sources d'argent avec leurs soldes.

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

    Ajoute une source d'argent. Obligatoires : type (bank, card, ewallet ou cash), holder_name. Facultatifs : bank_name, provider_name, card_type, card_last4, opening_balance, client_ref.

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

    Modifie une source d'argent.

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

    Supprime une source d'argent.

Tout autre chemin répond 403 à une clé API, même si l'app elle-même l'utilise.

Exemple : enregistrer une vente

Une caisse peut enregistrer chaque vente comme un revenu. Donnez à chaque vente son propre client_ref, pour qu'un nouvel essai après une erreur réseau n'enregistre pas la vente deux fois.

Requête
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"
  }'

La réponse a le statut 201 et l'id de la nouvelle transaction dans data.id.

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

client_ref contient de 8 à 64 lettres, chiffres ou tirets. Si le compte a déjà une transaction avec le même client_ref, l'API renvoie cette transaction au lieu d'en enregistrer une nouvelle.

Réponses et erreurs

Une réponse réussie place le résultat dans data. Une réponse en échec contient un message dans error, dans la langue du compte, et souvent un code identique dans toutes les langues.

Réponse 403
{
  "error": "This API key does not have the permission for this request",
  "code": "api_key_scope_missing",
  "scope": "transactions:write"
}
401
La clé ou le secret manque ou est faux, ou la clé a été révoquée ou a expiré.
403
La clé n'a pas l'autorisation pour cette requête, le chemin est fermé aux clés API ou le compte est bloqué.
404
L'élément n'existe pas dans ce compte.
422
Un champ manque ou n'est pas valide. Quand fields est présent, il indique ce qu'il faut corriger.
429
Trop de requêtes. Attendez le nombre de secondes indiqué dans l'en-tête Retry-After.

Limites

Chaque clé peut envoyer jusqu'à 60 requêtes par minute. Les limites de votre offre s'appliquent toujours, comme dans l'app. Avec l'offre Free, cela signifie jusqu'à 30 nouvelles transactions par jour.

Protégez vos clés

  • Gardez le secret à un seul endroit, comme les réglages de votre caisse, et ne le partagez ni par messagerie ni par e-mail.
  • Cochez uniquement les autorisations dont le système a besoin.
  • Si un secret fuite, révoquez la clé dans l'app et créez-en une nouvelle.
  • L'app indique quand votre clé a été utilisée pour la dernière fois. Si cela ne correspond pas à vos propres systèmes, révoquez la clé.

Des questions sur l'API ? Écrivez à ariefzufar@arizu.id / arizu.team@gmail.com.