開発者向けAPI

POSレジやスクリプトなど別のシステムから、自分のMoney Trackerアカウントの取引、カテゴリ、資金源を読み取り、記録できます。キーが扱えるのは、そのキーを作成したアカウントのデータだけです。

ベースURL
https://moneytracker.arizu.id
認証
X-Api-Key
X-Api-Secret
形式
HTTPS経由のJSON
制限
キーごとに1分あたり60件

キーを作成する

  1. Money Trackerアプリで「プロフィール」を開き、「APIキー」を選びます。
  2. 「キーを作成」をタップし、名前を付けて、許可する操作にチェックを入れます。
  3. API_KEYとAPI_SECRETをコピーします。シークレットは一度しか表示されません。

有効なキーは1アカウントにつき1つです。差し替えるには、同じ画面でキーを取り消してから新しく作成します。取り消したキーはすぐに使えなくなります。

認証

毎回のリクエストで、両方の値をヘッダーとして送信します。シークレットをURL、Webページ、他の人が開けるアプリに含めないでください。

X-Api-Key
あなたのAPI_KEY。mtu_で始まります。
X-Api-Secret
あなたのAPI_SECRET。英数字40文字です。
リクエスト
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"

権限

キーには、チェックを入れた権限だけが付与されます。書き込み権限には読み取り権限も含まれます。

transactions:read
取引の読み取り
transactions:write
取引の記録・変更・削除
categories:read
カテゴリの読み取り
categories:write
カテゴリの追加・削除
money_sources:read
資金源と残高の読み取り
money_sources:write
資金源の追加・変更・削除
profile:read
アカウントの名前、メール、通貨、言語、プランの読み取り

エンドポイント

パスはベースURLからの相対パスです。金額はアカウントの通貨で表されます。

アカウント

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

    アカウントのプロフィール。

取引

  • GET/api/v1/transactionstransactions:read

    取引の一覧(新しい順)。フィルター:month(2026-11)、type(incomeまたはexpense)、source_id、page、per_page(最大100)。

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

    取引1件。

  • POST/api/v1/transactionstransactions:write

    取引を記録します。必須:type、amount、occurred_on(2026-11-02)。任意:category_id、payment_source_id、note(最大255文字)、client_ref。

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

    取引を変更します。記録時と同じフィールドを、client_refを除いて送信します。

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

    取引を削除します。

カテゴリ

  • GET/api/v1/categoriescategories:read

    収入と支出のカテゴリ。

  • POST/api/v1/categoriescategories:write

    カテゴリを追加します。必須:type、name。任意:icon、color(#RRGGBB)、client_ref。

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

    カテゴリを削除します。

資金源

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

    資金源と残高。

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

    資金源を追加します。必須:type(bank、card、ewallet、cashのいずれか)、holder_name。任意:bank_name、provider_name、card_type、card_last4、opening_balance、client_ref。

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

    資金源を変更します。

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

    資金源を削除します。

それ以外のパスは、アプリ自体が使っているものでも、APIキーには403を返します。

例:売上を記録する

POSレジは、売上ごとに収入として記録できます。売上ごとに別のclient_refを付ければ、ネットワークエラー後に再送しても二重に記録されません。

リクエスト
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"
  }'

レスポンスのステータスは201で、新しい取引のIDがdata.idに入ります。

レスポンス 201
{
  "data": {
    "id": 58213,
    "amount": "125000.00",
    "currency": "IDR",
    "original_amount": null,
    "original_currency": null,
    "fx_rate": null,
    "fx_date": null
  }
}

client_refは8〜64文字の英字、数字、ハイフンです。同じclient_refの取引がすでにある場合、APIは新しく記録せず、その取引を返します。

レスポンスとエラー

成功したレスポンスは、結果をdataに入れて返します。失敗したレスポンスには、アカウントの言語のメッセージがerrorに入り、多くの場合、どの言語でも変わらないcodeも含まれます。

レスポンス 403
{
  "error": "This API key does not have the permission for this request",
  "code": "api_key_scope_missing",
  "scope": "transactions:write"
}
401
キーまたはシークレットがない、間違っている、またはキーが取り消されたか期限切れです。
403
キーにこのリクエストの権限がない、パスがAPIキーに開放されていない、またはアカウントがブロックされています。
404
そのデータはこのアカウントに存在しません。
422
項目が不足しているか、無効です。fieldsがある場合は、修正が必要な項目が示されます。
429
リクエストが多すぎます。Retry-Afterヘッダーの秒数だけ待ってください。

制限

各キーは1分あたり最大60件のリクエストを送れます。アプリと同じく、プランの制限も適用されます。Freeプランでは、新しい取引は1日30件までです。

キーを安全に保つ

  • シークレットはPOSレジの設定など1か所だけに保存し、チャットやメールで共有しないでください。
  • システムに必要な権限だけにチェックを入れます。
  • シークレットが漏れたら、アプリでキーを取り消して新しいキーを作成します。
  • アプリにはキーの最終使用日時が表示されます。自分のシステムと合わない場合は、キーを取り消してください。

APIについてのご質問は、ariefzufar@arizu.id / arizu.team@gmail.comまでご連絡ください。