Obtenir une clé
- Dans l'app Money Tracker, ouvrez Profil puis choisissez Clés API.
- Touchez Créer une clé, donnez-lui un nom et cochez ce qu'elle peut faire.
- 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.
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:readLe profil du compte.
Transactions
-
GET
/api/v1/transactionstransactions:readLes 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:readUne transaction.
-
POST
/api/v1/transactionstransactions:writeEnregistre 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:writeModifie une transaction. Envoyez les mêmes champs que pour l'enregistrer, sans client_ref.
-
DELETE
/api/v1/transactions/{id}transactions:writeSupprime une transaction.
Catégories
-
GET
/api/v1/categoriescategories:readLes catégories de revenus et de dépenses.
-
POST
/api/v1/categoriescategories:writeAjoute une catégorie. Obligatoires : type, name. Facultatifs : icon, color (#RRGGBB), client_ref.
-
DELETE
/api/v1/categories/{id}categories:writeSupprime une catégorie.
Sources d'argent
-
GET
/api/v1/payment-sourcesmoney_sources:readLes sources d'argent avec leurs soldes.
-
POST
/api/v1/payment-sourcesmoney_sources:writeAjoute 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:writeModifie une source d'argent.
-
DELETE
/api/v1/payment-sources/{id}money_sources:writeSupprime 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.
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.
{
"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.
{
"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.