キーを作成する
- Money Trackerアプリで「プロフィール」を開き、「APIキー」を選びます。
- 「キーを作成」をタップし、名前を付けて、許可する操作にチェックを入れます。
- 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に入ります。
{
"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も含まれます。
{
"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までご連絡ください。