ForHosting KIT · 暮らし・料理・趣味

買い物予算トラッカー

Q: カートの各行に名前が必要ですか？

いいえ。 名前は任意です。裸の数値は価格として扱われ、無名の行には表示用の安定ラベル Item 1 などが付きます。

予算100で牛乳、パン、卵、りんごの合計が10.53なら、残りは89.47です。商品を1つ足すたびに残額が表示されるので、レジの前にどの商品で予算を超えるかが分かります。ブラウザで無料で使えます。

無料
ブラウザで動作
登録不要
データは端末の外に出ません

無料で実行 API仕様を見る

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

計算例

入力した場合

予算: 100

結果

項目数: 4
支出合計: 10.53
残り: 89.47
超過額: 0

買い物予算トラッカーは、レジ前に実用的な一点を答えます。この品目価格のリストを反映したあと、いくら残っているか、すでに上限を超えていないかです。買い物をする方、家計を立てる方、小規模な小売ツールには、店舗カタログを取得したり税率を捏造したりしない確定的な答えが必要です。本買い物予算計算は、総予算と価格付きカート行を1件以上受け取り、支出を合算して予算から差し引き、残額、超過の有無、超過額、各行後のランニング残額を返し、どの追加でカートが上限を超えたかを示します。

残額と予算超過の計算方法

棚札価格にすでに使っている通貨単位で、非負の買い物予算から始めてください。本計算は為替換算やレート適用を行いません。カートの各行には有限で非負の価格を取り、任意の名称は表示用のラベルになります。

合計支出はリスト内の全価格の和です。残額は予算からその合計を引いた値です。残額がゼロ以上なら予算内、厳密に負なら予算超過であり、超過額は残額の絶対値です。

予算がゼロより大きい場合は使用率（パーセント）も返し、百の枠に対して三十のカートなら三十パーセント使用と示し、クライアント側の比率再計算を不要にします。予算ゼロも許可され、正の支出はすべて超過として報告され、すでに枠が尽きた封筒ルールと一致します。価格ゼロの無料サンプルは受け付けられ、合計を変えません。

負の予算や負の価格は、本製品における物理的な買い物枠や棚価格を表さないため拒否されます。

活用例

週間食料の封筒管理

週間の食費予算と通路の価格を買い物しながら入力し、残額を見守り、カートが上限を超えそうなら止めてください。

世帯の共有カート

同居者が共通予算と共同品目リストを投稿し、全員が同じ合計支出・残額・超過フラグを確認できます。

よくある質問

カートの各行に名前が必要ですか？

いいえ。名前は任意です。裸の数値は価格として扱われ、無名の行には表示用の安定ラベル Item 1 などが付きます。

買い物予算トラッカーはどのように計算しますか？

リストのすべての価格を合計し、予算から差し引いて残額を出します。残額が0以上なら予算内、マイナスなら予算超過です。予算が0より大きいときは、使った割合も表示します。

予算を超えるとどうなりますか？

残額がマイナスになり、予算超過として表示されます。どれだけ超えたかも示され、その額はマイナスの残額から符号を外した値です。

どの商品で予算を超えたか分かりますか？

分かります。価格は順番に差し引かれ、1行ごとに残額が表示されるため、残額が初めてマイナスになった行の商品が予算を超えさせた商品です。

税金の加算や通貨の換算はしますか？

しません。入力した価格をそのまま足し引きするだけで、税率を加えたり為替レートで換算したりはしません。予算と価格は同じ通貨で入力してください。

開発者向け — APIアクセス

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

エンドポイント

POSThttps://api.kit.forhosting.com/life/shopping-budget

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

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

curl -X POST https://api.kit.forhosting.com/life/shopping-budget \
  -H "Authorization: Bearer $KIT_KEY" \
  -H "Content-Type: application/json" \
  -d '{"budget":100,"items":[{"name":"Milk 1 L","price":1.49},{"name":"Bread","price":2.25},{"name":"Eggs (12)","price":3.8},{"name":"Apples 1 kg","price":2.99}]}'

const res = await fetch("https://api.kit.forhosting.com/life/shopping-budget", {
  method: "POST",
  headers: {
    "Authorization": `Bearer ${process.env.KIT_KEY}`,
    "Content-Type": "application/json"
  },
  body: JSON.stringify({
    "budget": 100,
    "items": [
      {
        "name": "Milk 1 L",
        "price": 1.49
      },
      {
        "name": "Bread",
        "price": 2.25
      },
      {
        "name": "Eggs (12)",
        "price": 3.8
      },
      {
        "name": "Apples 1 kg",
        "price": 2.99
      }
    ]
  })
});
const { task_id } = await res.json();

import os, requests

res = requests.post(
    "https://api.kit.forhosting.com/life/shopping-budget",
    headers={"Authorization": f"Bearer {os.environ['KIT_KEY']}"},
    json={
    "budget": 100,
    "items": [
        {
            "name": "Milk 1 L",
            "price": 1.49
        },
        {
            "name": "Bread",
            "price": 2.25
        },
        {
            "name": "Eggs (12)",
            "price": 3.8
        },
        {
            "name": "Apples 1 kg",
            "price": 2.99
        }
    ]
},
)
task_id = res.json()["task_id"]

<?php
$res = file_get_contents("https://api.kit.forhosting.com/life/shopping-budget", false, stream_context_create([
  "http" => [
    "method"  => "POST",
    "header"  => "Authorization: Bearer " . getenv("KIT_KEY") . "\r\nContent-Type: application/json",
    "content" => '{"budget":100,"items":[{"name":"Milk 1 L","price":1.49},{"name":"Bread","price":2.25},{"name":"Eggs (12)","price":3.8},{"name":"Apples 1 kg","price":2.99}]}',
  ],
]));
$task = json_decode($res, true);

body := bytes.NewBufferString(`{"budget":100,"items":[{"name":"Milk 1 L","price":1.49},{"name":"Bread","price":2.25},{"name":"Eggs (12)","price":3.8},{"name":"Apples 1 kg","price":2.99}]}`)
req, _ := http.NewRequest("POST", "https://api.kit.forhosting.com/life/shopping-budget", body)
req.Header.Set("Authorization", "Bearer "+os.Getenv("KIT_KEY"))
req.Header.Set("Content-Type", "application/json")
res, _ := http.DefaultClient.Do(req)

リクエスト例

{
  "budget": 100,
  "items": [
    {
      "name": "Milk 1 L",
      "price": 1.49
    },
    {
      "name": "Bread",
      "price": 2.25
    },
    {
      "name": "Eggs (12)",
      "price": 3.8
    },
    {
      "name": "Apples 1 kg",
      "price": 2.99
    }
  ]
}

レスポンス例

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

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

料金

1リクエストあたり$0.002

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

エラー

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

技術的な注記

予算欠落、空リスト、負の価格など検証失敗は invalid_input として拒否され、課金されません。

入力契約、応答形、エラーの扱い

各行は価格として扱う裸の数値、または必須の price と任意の name を持つオブジェクトにできます。五百行を超えるリストは pure-parse 作業を抑えるため拒否されます。必須フィールドが2つのJSON本体をPOSTしてください。budget はゼロ以上の有限数、items は空でないカート行の配列です。price は cost や amount などの一般的な別名も受け付け、リスト欄自体は cart、prices、lines、list を別名にできます。budget は limit、max、total_budget、allowance を別名にでき、他の金銭ツールの語彙を再利用できます。成功時は予算、品目数、安定した名称と丸めた価格と当該行後のランニング残額を持つ各行、さらに total_spent、remaining、over_budget、over_amount、within_budget、percent_used、短い式文字列、人間向けメッセージ、ワークシート用の順序付き手順を返します。例：予算百、牛乳 one point four nine、パン two point two five、卵 three point eight、りんご two point nine nine では合計支出 ten point five three、残額 eighty-nine point four seven、over_budget false になります。同じ予算に百を超える行合計を組み合わせると over_budget は true、over_amount は超過幅を示します。これは成功応答でありエラーではなく、超過こそがトラッカーが答える問いだからです。予算欠落、空の items、非有限数、負の価格はフィールド名付きの invalid_input で失敗し課金されません。

買い物予算トラッカーが役立つ場面

家計アプリや共有の食料品リストは、スプレッドシートを開かずに同居者が品目をチェックしながら残額を見られるよう買い物予算トラッカーを使います。小売デモキオスクやPOS研修サンドボックスには、ライブ価格APIを決して呼ばない確定的な残金オラクルが必要です。個人金融の授業ではカート対予算の演習を出し、各行後の順序付きランニング残額を持つAPIにより、どの追加が最初に上限を超えたかを採点できます。週間献立を組む自動化スクリプトは材料行合計を送り、over_budget が true になったら補充注文を止められます。実装は pure parse の tier A のため、成功した各呼び出しはモデルトークンや外向き通信なしで公開された基本価格 $0.002 です。リクエストを小さく保ち、丸めた合計をテストに固定すれば、自前の台帳基盤を立てずにモバイルチェックリスト、LMSプラグイン、エッジワーカー向けの再現可能な残額を得られます。

連携の活用例

献立計画の自動化

スクリプトが固定枠に対して予定材料価格を送り、over_budget が true になったら補充を停止します。

技術的な質問

買い物予算トラッカー計算はどう動きますか？

非負の予算と空でない価格リストを送ってください。APIは価格を合算し、予算から差し引き、残額と remaining が負のときの over_budget を返します。

予算を超えたらどうなりますか？

呼び出しは成功したままです。remaining は負、over_budget は true、over_amount は超過幅を示します。予算超過は invalid_input とは扱いません。

品目価格をゼロにできますか？

はい。価格 0 の無料サンプルやプロモ行は許可されます。負の価格と負の予算は invalid_input として拒否されます。

買い物予算トラッカーの料金は？

ブラウザツールは無料です。APIリクエストは成功1回あたり $0.002 の前払いKIT残高を使い、無効な入力は課金されません。

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