ForHosting KIT · 開発者向けツール

パーティー用品の必要数量を計算

前提条件を明確にすると、使い捨て用品や再利用可能な食器の準備が簡単になります。参加人数を入力し、1人が使う皿、カップ、ナプキンの標準数を指定して、こぼれ、追加の料理、予期しない参加者に備える予備率を加えてください。計算結果には、各品目の購入に必要な整数の数量と総数が表示されます。誕生日会、披露宴、地域行事、職場の集まりなど、品切れを避けたいさまざまな催しにご利用いただけます。

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

無料で実行 API仕様を見る

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

現実的な参加人数と提供方法から始めます

実際に参加すると見込まれる人数から始めてください。飲食する可能性がある主催者、業者、出演者、ボランティアも含めます。次に、各用品の標準数を設定します。料理が1品なら1人1枚の皿で足りる場合がありますが、前菜、主菜、デザートを別々に出す場合は2枚または3枚必要です。カップの数は、記名した1個を使い続けるか、飲み物を替えるたびに交換するか、各提供場所で新しい物を渡すかによって変わります。ナプキンは、飲み物、食事、こぼれた物、片付けに使うため、多めに必要になる傾向があります。既定値は便利な出発点であり、すべての催しに当てはまる規則ではありません。献立、開催時間、年齢層、セルフサービスの方法、通常の食器を併用するかどうかもご検討ください。前提を記録しておけば、仕入先や共同主催者と確認しやすく、根拠の曖昧な支出を防げます。参加人数には正の整数だけをご入力ください。

予備率が各数量をどう変えるか確認します

参加人数に1人当たりの標準数を掛けた後、皿、カップ、ナプキンのそれぞれに予備率を適用します。たとえば、基本数が40枚の皿に10パーセントの予備を加えると44枚になります。結果に端数が生じた場合、用品を通常は端数で購入できないため、次の整数へ切り上げます。この安全側の処理により、小規模な集まりでは実質的な予備率がわずかに高くなることがあります。予備分は、落とした用品、破損した包装、標準を超える使用、軽微な人数変更に役立ちます。ただし、適切な収容計画の代わりにはなりません。参加人数が大きく変動しそうな場合は、人数を更新するか、実際のリスクに応じて予備率を増やしてください。飲み物だけの会で皿が不要な場合など、意図的に使わない品目には0を指定できます。結果には入力した標準数と予備率も表示されるため、計算の確認や複数案の比較が容易です。

結果を実用的な買い物リストに変えます

計算された数量を必要な個数として扱い、利用する店舗や仕入先の包装単位に換算してください。カップが50個入りで、結果が88個なら、使用できる在庫がない限り2袋購入します。包装単位の切り上げと催しの予備率は分けて考えてください。この計算機は必要な個数を示しますが、包装数は販売者によって異なります。総数は規模の把握に便利ですが、皿、カップ、ナプキンは相互に代用できないため、購入時には品目別の内訳をご使用ください。再利用可能な食器の場合も、同じ数値をレンタル数、洗浄能力、配置、予備品の計画に活用できます。入力値を買い物リストと一緒に保存すると、人数変更時にも一貫して再計算できます。単発の計画にはブラウザー版が便利です。多数の催しの見積書、確認表、標準注文を自動作成する場合は、1回$0.002でAPIを呼び出せます。

活用例

誕生日会を準備します

招待人数に応じた食器を見積もり、こぼれ、追加分、直前の参加者に備えて予備を加えます。

催事の見積書を作成します

1人当たりの統一基準を使い、お客様に分かりやすい用品見積もりをご提示いただけます。

地域の集まりを運営します

予想参加人数を、ボランティアや購買担当者が使える明確な品目別目標へ変換します。

よくある質問

参加人数が0または負の数の場合はどうなりますか？

参加人数には正の整数が必要なため、無効な入力としてエラーが返されます。

予備率はどのように適用されますか？

各基本数量に1と予備率の合計を掛け、次の整数の用品数へ切り上げます。

特定の用品を0に設定できますか？

はい。その用品が催しに不要な場合は0をご指定ください。

結果には包装単位も反映されますか？

いいえ。個数を返しますので、仕入先の包装数で割り、購入時に切り上げてください。

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

APIは1回$0.002です。ブラウザー内でもローカルに計算できます。

開発者向け — APIアクセス

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

エンドポイント

POSThttps://api.kit.forhosting.com/final3/party-supply-quantity-calc

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

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

curl -X POST https://api.kit.forhosting.com/final3/party-supply-quantity-calc \
  -H "Authorization: Bearer $KIT_KEY" \
  -H "Content-Type: application/json" \
  -d '{"guest_count":40}'

const res = await fetch("https://api.kit.forhosting.com/final3/party-supply-quantity-calc", {
  method: "POST",
  headers: {
    "Authorization": `Bearer ${process.env.KIT_KEY}`,
    "Content-Type": "application/json"
  },
  body: JSON.stringify({
    "guest_count": 40
  })
});
const { task_id } = await res.json();

import os, requests

res = requests.post(
    "https://api.kit.forhosting.com/final3/party-supply-quantity-calc",
    headers={"Authorization": f"Bearer {os.environ['KIT_KEY']}"},
    json={
    "guest_count": 40
},
)
task_id = res.json()["task_id"]

<?php
$res = file_get_contents("https://api.kit.forhosting.com/final3/party-supply-quantity-calc", false, stream_context_create([
  "http" => [
    "method"  => "POST",
    "header"  => "Authorization: Bearer " . getenv("KIT_KEY") . "\r\nContent-Type: application/json",
    "content" => '{"guest_count":40}',
  ],
]));
$task = json_decode($res, true);

body := bytes.NewBufferString(`{"guest_count":40}`)
req, _ := http.NewRequest("POST", "https://api.kit.forhosting.com/final3/party-supply-quantity-calc", body)
req.Header.Set("Authorization", "Bearer "+os.Getenv("KIT_KEY"))
req.Header.Set("Content-Type", "application/json")
res, _ := http.DefaultClient.Do(req)

リクエスト例

{
  "guest_count": 40
}

レスポンス例

{
  "task_id": "tsk_a1b2c3d4e5f6a1b2c3d4e5f6",
  "type": "final3.party_supply_quantity_calc",
  "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の完全なドキュメントを見る →