ForHosting KIT · 開発者向けツール

一食あたりの食費予算とカテゴリ別目安を計算

食料品に使える総額を、予定している各食事の実用的な予算に換算します。利用可能な金額と、その金額でまかなう食事回数を入力すると、一食あたりの平均額に加え、たんぱく源、青果、その他の購入枠が表示されます。標準配分は、たんぱく源に30パーセント、青果に30パーセント、その他に40パーセントです。同じ通貨を一貫して使えば、円、ドル、ユーロなど、どの通貨でも計算できます。

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

無料で実行 API仕様を見る

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

実際に使える金額から始めます

理想額や将来の収入ではなく、計画期間に食料品へ実際に使える総額を入力してください。次に、その同じ期間に食料品でまかなう食事を数えます。たとえば1週間に朝食7回、持参する昼食5回、夕食7回を予定し、昼食2回は外で済ませる場合、対象は19食です。計算結果は総額を食数で割り、最も近い1セント相当まで丸めた平均です。すべての料理に同額を使う必要はありません。安価なスープで節約した分を、別の日の高価な夕食に回せます。間食、飲料、常備品は食事数に含めるか、その他の枠で扱うかを決め、同じ方法を続けてください。比較用のシナリオでは予算0も有効ですが、食事回数は正の整数でなければなりません。月間予算を1週間分の食数だけで割るような期間のずれを避けると、誤解を招く金額になりません。

カテゴリ別の金額を目安として使います

標準配分では、たんぱく源に30パーセント、青果に30パーセント、その他に40パーセントを割り当てます。たんぱく源には肉、魚、卵、乳製品、豆腐、豆類などを含められます。青果は生鮮品だけでなく、冷凍や缶詰の果物・野菜も対象です。その他には穀類、パン、油、香辛料、ソース、飲料、間食、常備品などが入ります。これは栄養上の処方ではなく、買い物の支出目安です。摂取カロリーや分量を示すものではありません。価格や食生活によっては、たんぱく源の支出が目安を下回り、差額を青果や常備品へ回せます。また、長期間使う油を購入した週だけその他が超過する場合もあります。1枚のレシートではなく、計画期間全体で評価してください。金額は最小通貨単位で計算され、丸め差はその他に入るため、3カテゴリの合計は入力した総額と一致します。各カテゴリには一食あたりの目安も表示されます。

結果を献立と買い物に反映します

一食あたりの平均が分かったら、予定する料理と材料費を一覧にしてください。高価な料理も、オートミール、豆料理、パスタ、残り物などの安価な選択肢と組み合わせれば計画に残せます。会計前に、買い物リストをたんぱく源と青果の総額目安と比較します。超過している場合は、まず同じカテゴリ内で代替品を探してください。高級な肉を手頃な品に替える、旬の野菜や冷凍品を選ぶ、複数の料理で使える材料を選んで廃棄を減らす、といった方法があります。この結果は地域での購入可能性を保証しません。店舗価格、包装量、食事制限、割引、家の在庫、食べる人数は考慮していないためです。これらを判断するための安定した基準としてお使いください。旅行、来客、学校予定、外食などで予算や食数が変わったら再計算します。同じ計算はAPIから1回$0.002で利用できます。外部データを使わないため、同じ入力には常に同じ金額が返ります。

活用例

1週間の買い物を計画する

週間予算を、準備する朝食・昼食・夕食ごとの現実的な平均額に換算できます。

カテゴリの配分を確認する

会計前に、買い物リストをたんぱく源と青果の個別目安と比較できます。

予算案を比較する

予定、来客、資金が変わった際に、総額や食数を変更して複数案を比べられます。

よくある質問

どのような割合で配分されますか？

たんぱく源に30パーセント、青果に30パーセント、その他に40パーセントを配分します。

特定の通貨を使う必要がありますか？

いいえ。任意の通貨を使えますが、総額と比較では同じ通貨を一貫してお使いください。

食事回数が正の整数に限られるのはなぜですか？

平均には1食以上が必要であり、予定する食事は1回ずつ数えるためです。

カテゴリ目安は栄養上の助言ですか？

いいえ。支出の目安に限られ、食事療法、医療、栄養に関する助言の代わりにはなりません。

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

APIは1回$0.002です。固定された計算であり、リアルタイム価格は取得しません。

開発者向け — APIアクセス

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

エンドポイント

POSThttps://api.kit.forhosting.com/final3/grocery-budget-per-meal

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

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

curl -X POST https://api.kit.forhosting.com/final3/grocery-budget-per-meal \
  -H "Authorization: Bearer $KIT_KEY" \
  -H "Content-Type: application/json" \
  -d '{"total_budget":240,"meals":20}'

const res = await fetch("https://api.kit.forhosting.com/final3/grocery-budget-per-meal", {
  method: "POST",
  headers: {
    "Authorization": `Bearer ${process.env.KIT_KEY}`,
    "Content-Type": "application/json"
  },
  body: JSON.stringify({
    "total_budget": 240,
    "meals": 20
  })
});
const { task_id } = await res.json();

import os, requests

res = requests.post(
    "https://api.kit.forhosting.com/final3/grocery-budget-per-meal",
    headers={"Authorization": f"Bearer {os.environ['KIT_KEY']}"},
    json={
    "total_budget": 240,
    "meals": 20
},
)
task_id = res.json()["task_id"]

<?php
$res = file_get_contents("https://api.kit.forhosting.com/final3/grocery-budget-per-meal", false, stream_context_create([
  "http" => [
    "method"  => "POST",
    "header"  => "Authorization: Bearer " . getenv("KIT_KEY") . "\r\nContent-Type: application/json",
    "content" => '{"total_budget":240,"meals":20}',
  ],
]));
$task = json_decode($res, true);

body := bytes.NewBufferString(`{"total_budget":240,"meals":20}`)
req, _ := http.NewRequest("POST", "https://api.kit.forhosting.com/final3/grocery-budget-per-meal", body)
req.Header.Set("Authorization", "Bearer "+os.Getenv("KIT_KEY"))
req.Header.Set("Content-Type", "application/json")
res, _ := http.DefaultClient.Do(req)

リクエスト例

{
  "total_budget": 240,
  "meals": 20
}

レスポンス例

{
  "task_id": "tsk_a1b2c3d4e5f6a1b2c3d4e5f6",
  "type": "final3.grocery_budget_per_meal",
  "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`	リクエストが多すぎます。しばらく待ってから再度お試しください。

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