Calculadora de ratio de café

Los volúmenes de agua no positivos fallan con invalid_input en lugar de inventar una dosis, de modo que un llenado cero de tetera nunca se convierte en un disparo silencioso de cero gramos.

Cómo el volumen de agua y el ratio café-agua se convierten en masa de café

En la cocina práctica, la densidad del agua a temperatura ambiente es lo bastante cercana a un gramo por mililitro como para que los mililitros de agua de tetera igualen gramos de agua, de modo que la calculadora informa coffee_mass en gramos cuando usted mide water_volume en mililitros. Este endpoint no modela el rendimiento de extracción, los sólidos disueltos totales, el tiempo de floración ni el tamaño de molido: solo escala el café al agua para que pueda ajustar la báscula antes de moler. La identidad es coffee_mass igual a water_volume dividido por brew_ratio, con redondeo estable a doce decimales para que goldens y clientes API coincidan entre entornos JavaScript.

Contrato de entrada, valores por defecto, forma de respuesta y errores

Ejemplo: doscientos ochenta y ocho mililitros de agua con el ratio por defecto dieciséis dan dieciocho gramos de café molido. Envíe un cuerpo JSON con un número finito positivo obligatorio: water_volume (alias water, water_ml, volume, water_g, kettle)—los mililitros de agua de extracción, o gramos de agua a densidad unitaria. Opcionalmente envíe brew_ratio (alias ratio, coffee_to_water, water_ratio, brew, strength_ratio)—partes de agua por una parte de café; por defecto es dieciséis si se omite, el punto de partida habitual del filtro de uno a dieciséis. Ambos campos pueden llegar como números JSON o como cadenas numéricas. Un water_volume cero o negativo falla con invalid_input y un mensaje de que el volumen de agua debe ser positivo; esa es la ruta de error documentada y no se factura. Un brew_ratio cero o negativo falla igual porque un ratio no positivo dividiría el agua en una dosis sin sentido o infinita. water_volume ausente, cadenas vacías, valores no finitos y magnitudes absolutas superiores a un billón también fallan la validación. En caso de éxito el cuerpo repite water_volume y brew_ratio, devuelve coffee_mass como el cociente en gramos, ratio_label como cadena de visualización del tipo 1:16, formula como la identidad de forma cerrada y message como un resumen en una línea en inglés apto para la interfaz.

Dónde una calculadora de ratio de café resulta útil

Los baristas caseros que extraen en su taza favorita necesitan una dosis que siga el volumen de la tetera al pasar de una taza entre semana de doscientos cincuenta mililitros a un Chemex de fin de semana de quinientos sin reescribir una hoja de cálculo. Los formadores de cafetería imprimen fichas de ratio para el personal y quieren una comprobación en vivo cuando un cliente pide una taza más fuerte o más suave mientras el volumen del tanque de lote permanece fijo. Prefiera esta capacidad cuando ya conozca el volumen de agua y el ratio café-agua; no es un conversor de tazas a gramos por densidad, ni una calculadora de miligramos de cafeína, ni el ayudante inverso que parte del peso del grano para hallar el agua. Sitios de recetas y aplicaciones móviles guardan estilos como números de ratio y llaman a un convertidor mínimo al pintar una guía de extracción a partir del volumen de agua que introduce el usuario, rellenando coffee_mass en la ficha antes de la lista de compra. Como la implementación es parse puro de tier A, cada llamada exitosa cuesta el precio base publicado $0.002 sin tokens de modelo ni red externa. Las tareas fallidas con invalid_input no consumen saldo prepago, lo que mantiene baratos los scripts exploratorios cuando usted envía a propósito un volumen cero para verificar el manejo de errores. Fije el coffee_mass redondeado en las pruebas y obtendrá gramos reproducibles para teteras, landings y workers de borde sin montar una hoja de cálculo propia.