Calculateur calories café

Si sugar_teaspoons est négatif, la tâche échoue avec invalid_input au lieu d'inventer un total énergétique négatif.

Type de café et table de kilocalories de base

Un calculateur de calories de café sain n'est utile que lorsque le nom de la boisson est lié à un chiffre d'énergie connu, et non à une spécialité de café vague. Si vous avez besoin d'une boisson de café sur mesure, choisissez le type le plus proche et placez les millilitres réels de lait et les cuillères à café de sucre dans les autres champs ; ce point d'accès n'accepte pas une surcharge calorique en texte libre, car un nombre libre rendrait inutile la page du type de café. Cette capacité stocke une table fermée de kilocalories de base pour la seule portion de café, sans lait et sans sucre, pour treize types canoniques : 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 et turkish à 7. Ces chiffres sont des valeurs typiques de style USDA du café infusé lui-même, si bien qu'un latte et un cappuccino partagent la même énergie de base et diffèrent par le lait que vous envoyez à part. Le champ coffee_type est un enum : le formulaire dessine une liste, l'API refuse les chaînes inconnues avec invalid_input, et deux clients ne divergent jamais sur le fait que latte désigne une boisson d'espresso tournée vers le lait. Les alias tels que drip, black coffee, cold brew et flat white se résolvent vers les identifiants canoniques, mais la réponse répète toujours la clé canonique.

Volume de lait, cuillères de sucre et identité calorique

L'essentiel de l'énergie d'une boisson de café n'est pas l'espresso. C'est le lait et le sucre. Le volume de lait est obligatoire et se mesure en millilitres. Zéro millilitre est une tasse noire ; un jet typique de cappuccino tourne autour de 120 millilitres et un versement de latte fait souvent 180 millilitres ou plus. Les fractions sont permises lorsqu'on a utilisé une demi-cuillère ; zéro cuillère n'apporte aucune énergie de sucre. Les calories du lait utilisent du lait entier de vache à 64 kilocalories pour 100 millilitres, si bien que milk_kcal égale milk_volume fois 64 divisé par 100. Le modèle ne bascule pas vers l'écrémé, l'avoine ni l'amande : ces boissons ont des densités et des étiquettes différentes, et les mêler dans un seul champ de volume ferait signifier deux énergies distinctes au même décompte de millilitres. sugar_teaspoons est obligatoire et compte le sucre cristallisé. Chaque cuillère à café est traitée comme 4 grammes à 4 kilocalories par gramme, soit 16 kilocalories, si bien que sugar_kcal égale sugar_teaspoons fois 16. Une valeur négative de sugar_teaspoons n'est pas une tasse, c'est une erreur de données, et la tâche échoue avec invalid_input en nommant le champ et en indiquant que les cuillères à café de sucre ne peuvent pas être négatives. Ces échecs ne sont pas facturés. Les calories totales égalent coffee_kcal plus milk_kcal plus sugar_kcal.

Contrat d'entrée, forme de la réponse et place dans un flux

Associez le chiffre à votre journal alimentaire ou à votre budget restant ; ce point d'accès ne convertit qu'une boisson de café en kilocalories. Une validation en échec ne consomme pas de solde. Envoyez un corps JSON avec trois champs obligatoires : coffee_type (l'un des treize identifiants canoniques), milk_volume (millilitres non négatifs, maximum 2000) et sugar_teaspoons (décompte non négatif, maximum 50). Le gestionnaire accepte des alias : type, coffee, drink ou drink_type pour coffee_type ; milk, milk_ml, milk_volume_ml ou volume pour milk_volume ; sugar, teaspoons, tsp ou sugar_tsp pour sugar_teaspoons. Champs manquants, nombres non finis, type de café inconnu, volume de lait négatif, décompte de sucre négatif et valeurs au-dessus des limites déclarées échouent en invalid_input avec un message qui nomme le champ. En cas de succès le corps inclut coffee_type, milk_volume et sugar_teaspoons renvoyés ; coffee_kcal issu de la table ; milk_kcal ; sugar_kcal ; calories comme la somme ; et une courte chaîne de formule. Exemple : coffee_type latte, milk_volume 180, sugar_teaspoons 1 donne 5 plus 115.2 plus 16, soit 136.2 kilocalories. Comme l'implémentation est du parse pur de tier A, chaque appel réussi coûte le prix de base publié $0.002 sans jetons de modèle et sans réseau sortant.