ForHosting KIT · 開発者向けツール

購入額の切り上げ貯金計算ツール

この切り上げ貯金計算ツールでは、日々の購入額を次の整数ドルまで切り上げると、いくら貯められるかを確認できます。1件以上の購入額を入力すると、元の金額、切り上げ後の金額、取り分ける金額を取引ごとに返します。さらに全取引の積立額を明確な合計にまとめるため、銀行の切り上げサービスの照合、貯金習慣の試算、表計算式を使わない取引確認にご利用いただけます。

● Beta無料・ブラウザ内で実行

無料で実行 API仕様を見る

ご利用方法ウェブAPIメールTelegramアプリ近日

購入額の切り上げが貯金になる仕組み

切り上げ貯金では、購入額と次の整数ドルとの差額を求め、その差額を貯金へ回します。たとえば3.45の購入は、次の整数額が4.00であるため、0.55の貯金になります。購入額がすでに整数ドルの場合は差額が発生せず、さらに1ドルを加えることもありません。この計算ツールは、purchasesに含まれる各金額へ同じ規則を個別に適用します。結果には購入額、切り上げ後の金額、その取引による貯金額が保存され、最後にすべての貯金額をtotal_savingsへ合計します。明細と合計を一緒に返すため、合計の1セントごとに元の購入を確認できます。金額は0以上で、小数点以下は2桁までです。通常の通貨入力に合わせた条件であり、1セント未満の曖昧な値を防ぎます。計算は整数のセント単位で行うため、2進浮動小数点で生じる一般的な誤差が金額結果へ混入しません。

正確な購入一覧を入力する方法

結果に表示したい順序で購入額を入力してください。各項目には、切り上げサービスが実際に受け取る最終決済額を指定します。税金、割引、チップが確定した請求額に含まれる場合は、それらを反映した金額をお使いください。切り上げ後の金額は自動計算されるため、入力する必要はありません。0は入力でき、貯金額も0になります。負の値は、返金や取消時の処理が金融機関ごとに異なるため受け付けません。一覧には少なくとも1件が必要で、最大10,000件まで処理できます。長期間の履歴にも対応しつつ、ブラウザーとAPIの処理量を適切に制限しています。照合に利用する場合は、同じ明細期間の金額を元の順序で入力してください。purchase_countは処理件数を示し、round_upsには入力ごとに1件の記録が入ります。想定件数と異なる場合は、合計を利用する前に元データをご確認ください。APIによる自動処理は1リクエストあたり$0.002です。

合計の読み方と貯金方法の比較

total_savingsは、入力したすべての購入に次の整数ドルへの切り上げを適用した場合の積立合計です。購入額そのものの合計ではなく、利息、金融機関からの上乗せ、振込手数料、最低振込額も含みません。これらの条件は銀行やアプリごとに異なるため、まず基本の切り上げ合計を求め、その後で別途反映してください。明細を見ると、支出総額が似た期間でも貯金額が異なる理由を確認できます。整数ドルをわずかに超える価格が多いと差額は大きくなり、次の整数ドルに近い価格では数セントしか増えません。計画には典型的な1週間または1か月の一覧を計算し、取引傾向が実際に繰り返される場合に限って将来へ延長してください。照合では、総額の前に各savings_amountを金融機関の記録と比較すると、対象外の取引や整数額の扱いの違いを発見できます。入力順序は保持され、全金額はセント単位で計算されます。

活用例

毎月の貯金習慣を試算

代表的な1か月の購入を計算し、切り上げによって取り分けられる金額を確認します。

銀行の切り上げ記録を確認

購入ごとの貯金額と合計を、銀行や貯金アプリに表示された振込記録と比較します。

予算管理へ切り上げを追加

書き出した取引額を処理し、再現可能な明細結果をレポートやダッシュボードへ渡します。

よくある質問

各取引の切り上げ額はどのように計算されますか？

購入額を次の整数ドルまで増やし、その差額を貯金とします。整数ドルの購入による貯金は0です。

購入額がすでに.00で終わる場合はどうなりますか？

金額は変わらず、合計貯金額への追加も0です。さらに1ドルを加えることはありません。

返金や負の取引を入力できますか？

いいえ。金融機関によって返金と取消後の切り上げ処理が異なるため、負の金額は受け付けません。

小数点以下が2桁までなのはなぜですか？

ドルとセントの取引を扱うためです。1セント未満を拒否することで、各明細と合計を明確に保ちます。

合計には利息や銀行の上乗せが含まれますか？

いいえ。入力された購入から生じる切り上げ差額だけが含まれます。

APIでの計算料金はいくらですか？

APIリクエスト1回の料金は$0.002です。公開されている上限内で複数の購入額を指定できます。

開発者向け — APIアクセス

このページの機能はすべてAPIからも利用できます。自社システムに組み込みたいチーム向けのセクションです。それ以外の方は上のツールをそのままお使いください。

エンドポイント

POSThttps://api.kit.forhosting.com/fin/round-up-savings-calc

Bearerトークンで認証し、POST1回でタスクをキューに登録します。結果はWebhookまたは署名付きリンクで受け取れます。

お使いのスタックから呼び出す

curl -X POST https://api.kit.forhosting.com/fin/round-up-savings-calc \
  -H "Authorization: Bearer $KIT_KEY" \
  -H "Content-Type: application/json" \
  -d '{"purchases":[3.45,12,8.99,0.01]}'

const res = await fetch("https://api.kit.forhosting.com/fin/round-up-savings-calc", {
  method: "POST",
  headers: {
    "Authorization": `Bearer ${process.env.KIT_KEY}`,
    "Content-Type": "application/json"
  },
  body: JSON.stringify({
    "purchases": [
      3.45,
      12,
      8.99,
      0.01
    ]
  })
});
const { task_id } = await res.json();

import os, requests

res = requests.post(
    "https://api.kit.forhosting.com/fin/round-up-savings-calc",
    headers={"Authorization": f"Bearer {os.environ['KIT_KEY']}"},
    json={
    "purchases": [
        3.45,
        12,
        8.99,
        0.01
    ]
},
)
task_id = res.json()["task_id"]

<?php
$res = file_get_contents("https://api.kit.forhosting.com/fin/round-up-savings-calc", false, stream_context_create([
  "http" => [
    "method"  => "POST",
    "header"  => "Authorization: Bearer " . getenv("KIT_KEY") . "\r\nContent-Type: application/json",
    "content" => '{"purchases":[3.45,12,8.99,0.01]}',
  ],
]));
$task = json_decode($res, true);

body := bytes.NewBufferString(`{"purchases":[3.45,12,8.99,0.01]}`)
req, _ := http.NewRequest("POST", "https://api.kit.forhosting.com/fin/round-up-savings-calc", body)
req.Header.Set("Authorization", "Bearer "+os.Getenv("KIT_KEY"))
req.Header.Set("Content-Type", "application/json")
res, _ := http.DefaultClient.Do(req)

リクエスト例

{
  "purchases": [
    3.45,
    12,
    8.99,
    0.01
  ]
}

レスポンス例

{
  "task_id": "tsk_a1b2c3d4e5f6a1b2c3d4e5f6",
  "type": "fin.round_up_savings_calc",
  "status": "queued",
  "_links": {
    "result": "/tasks/tsk_…/result"
  }
}

非同期APIです。task_idは即時に返ります。ポーリングは1秒あたり1リクエストまでです。

料金

1リクエストあたり$0.002

単価はすべて公開しています。トークン換算や独自クレジットはありません。失敗したタスクは課金されません。

制限

max_items 10000

エラー

HTTP	コード	意味
`401`	`unauthorized`	APIキーが無効か、指定されていません。Authorizationヘッダーを確認してください。
`402`	`insufficient_balance`	残高が不足しています。チャージ後に再度お試しください。
`404`	`unknown_type`	指定されたタスクタイプは存在しません。タイプ名を確認してください。
`429`	`rate_limited`	リクエストが多すぎます。しばらく待ってから再度お試しください。

KITの完全なドキュメントを見る →