Calculadora de calorías de café

Si sugar_teaspoons es negativo, la tarea falla con invalid_input en lugar de inventar un total energético negativo.

Tipo de café y la tabla de kilocalorías de base

Una calculadora de calorías de café saludable solo es útil cuando el nombre de la bebida va unido a una cifra de energía conocida, no a un especial de cafetería vago. Esas cifras son valores típicos al estilo USDA del café infusionado en sí, de modo que un latte y un cappuccino comparten la misma energía de base y se diferencian en la leche que se envía aparte. Esta capacidad guarda una tabla cerrada de kilocalorías de base para la porción de café sola, sin leche y sin azúcar, para trece tipos canónicos: espresso a 3, doppio a 6, americano a 5, black a 2, cold_brew a 5, latte a 5, cappuccino a 5, flat_white a 5, macchiato a 3, french_press a 7, pour_over a 5, instant a 4 y turkish a 7. El campo coffee_type es un enum: el formulario pinta un selector, la API rechaza cadenas desconocidas con invalid_input, y dos clientes nunca discrepan sobre si latte significa una bebida de espresso con leche al frente. Alias como drip, black coffee, cold brew y flat white se resuelven a los identificadores canónicos, pero la respuesta siempre repite la clave canónica. Si necesita una bebida de cafetería a medida, elija el tipo más cercano y ponga los mililitros reales de leche y las cucharaditas de azúcar en los otros campos; este endpoint no admite un recargo de calorías en texto libre, porque un número libre haría inútil la página del tipo de café.

Volumen de leche, cucharaditas de azúcar e identidad calórica

Las calorías de la leche usan leche entera de vaca a 64 kilocalorías por 100 mililitros, de modo que milk_kcal equivale a milk_volume por 64 dividido entre 100. El modelo no cambia a desnatada, avena ni almendra: esas bebidas tienen densidades y etiquetas distintas, y mezclarlas en un solo campo de volumen haría que el mismo recuento de mililitros significara dos energías diferentes. sugar_teaspoons es obligatorio y cuenta azúcar granulada. Cada cucharadita se trata como 4 gramos a 4 kilocalorías por gramo, que son 16 kilocalorías, de modo que sugar_kcal equivale a sugar_teaspoons por 16. Un valor negativo de sugar_teaspoons no es una taza, es un error de datos, y la tarea falla con invalid_input nombrando el campo y afirmando que las cucharaditas de azúcar no pueden ser negativas. Las calorías totales equivalen a coffee_kcal más milk_kcal más sugar_kcal.

Contrato de entrada, forma de la respuesta y encaje

La validación fallida no consume saldo. Envíe un cuerpo JSON con tres campos obligatorios: coffee_type (uno de los trece identificadores canónicos), milk_volume (mililitros no negativos, máximo 2000) y sugar_teaspoons (recuento no negativo, máximo 50). El manejador acepta alias: type, coffee, drink o drink_type para coffee_type; milk, milk_ml, milk_volume_ml o volume para milk_volume; sugar, teaspoons, tsp o sugar_tsp para sugar_teaspoons. Campos ausentes, números no finitos, un tipo de café desconocido, un volumen de leche negativo, un recuento de azúcar negativo y valores por encima de los límites declarados fallan como invalid_input con un mensaje que nombra el campo. En caso de éxito el cuerpo incluye el coffee_type, milk_volume y sugar_teaspoons repetidos; coffee_kcal de la tabla; milk_kcal; sugar_kcal; calories como la suma; y una cadena breve de fórmula. Ejemplo: coffee_type latte, milk_volume 180, sugar_teaspoons 1 produce 5 más 115.2 más 16, que son 136.2 kilocalorías. Combine la cifra con su diario de comidas o su presupuesto restante; este endpoint solo convierte una bebida de café en kilocalorías. Como la implementación es parse puro de tier A, cada llamada correcta cuesta el precio base publicado $0.002 sin tokens de modelo y sin red de salida.