ヘルシーコーヒーカロリー計算

sugar_teaspoons が負なら負のエネルギー合計を捏造せず invalid_input で失敗します。

コーヒータイプと基礎キロカロリー表

espresso は 3、doppio は 6、americano は 5、black は 2、cold_brew は 5、latte は 5、cappuccino は 5、flat_white は 5、macchiato は 3、french_press は 7、pour_over は 5、instant は 4、turkish は 7 です。これらは抽出したコーヒーそのものの典型的な USDA 風の値なので、latte と cappuccino は同じコーヒー基礎エネルギーを共有し、別に送る牛乳で差が付きます。フィールド coffee_type は enum です。フォームは選択欄を描き、API は未知文字列を invalid_input で拒み、latte が牛乳寄りのエスプレッソ飲料を指すかどうかで二つのクライアントが食い違うことはありません。このエンドポイントは自由記述のカロリー上書きを受け付けません。

牛乳量・砂糖小さじとカロリー恒等式

牛乳からのカロリーは全乳を 100 ミリリットルあたり 64 キロカロリーとし、milk_kcal は milk_volume に 64 を掛け 100 で割ったものです。sugar_teaspoons は必須でグラニュー糖を数えます。小さじ一杯はグラム 4、グラムあたり 4 キロカロリー、すなわち 16 キロカロリーとして扱い、sugar_kcal は sugar_teaspoons に 16 を掛けたものです。負の sugar_teaspoons は一杯ではなくデータ誤りであり、フィールド名を挙げ砂糖の小さじは負にできないと述べる invalid_input で失敗します。それらの失敗は課金されません。総カロリーは coffee_kcal に milk_kcal と sugar_kcal を足したものです。

入力契約、応答の形、使いどころ

ハンドラは別名を受け付けます。日々の残り予算が必要なら食事日記と組み合わせてください。検証失敗は残高を消費しません。必須三欄の JSON 本体を POST してください。coffee_type（十三の正規 id の一つ）、milk_volume（非負のミリリットル、最大 2000）、sugar_teaspoons（非負の個数、最大 50）です。coffee_type には type、coffee、drink、drink_type。milk_volume には milk、milk_ml、milk_volume_ml、volume。sugar_teaspoons には sugar、teaspoons、tsp、sugar_tsp です。欠落欄、非有限数、未知のコーヒータイプ、負の牛乳量、負の砂糖数、宣言上限を超える値はいずれもフィールド名を含む invalid_input になります。成功時の本体にはエコーした coffee_type、milk_volume、sugar_teaspoons、表の coffee_kcal、milk_kcal、sugar_kcal、合計の calories、短い公式文字列が含まれます。例として coffee_type latte、milk_volume 180、sugar_teaspoons 1 は 5 足す 115.2 足す 16、すなわち 136.2 キロカロリーを返します。本エンドポイントはコーヒー飲料をキロカロリーへ変換するだけです。実装は純粋な parse の tier A のため、成功呼び出しは公表の基本料金 $0.002 で、モデルトークンも外向きネットワークもありません。