Calculadora de ratio de café

Volumes de água não positivos falham com invalid_input em vez de inventar uma dose, de modo que um enchimento zero da chaleira nunca vira um shot silencioso de zero gramas.

Como o volume de água e o ratio café-água viram massa de café

No trabalho prático de cozinha, a densidade da água à temperatura ambiente fica perto o bastante de um grama por mililitro para que mililitros de água da chaleira igualem gramas de água, então a calculadora informa coffee_mass em gramas quando você mede water_volume em mililitros. Este endpoint não modela rendimento de extração, sólidos dissolvidos totais, tempo de floração nem granulometria—apenas escala o café à água para você ajustar a balança antes de moer. A identidade é coffee_mass igual a water_volume dividido por brew_ratio, com arredondamento estável a doze casas decimais para que goldens e clientes API coincidam entre runtimes JavaScript.

Contrato de entrada, padrões, formato da resposta e erros

Exemplo: duzentos e oitenta e oito mililitros de água no ratio padrão dezesseis geram dezoito gramas de café moído. Envie um corpo JSON com um número finito positivo obrigatório: water_volume (aliases water, water_ml, volume, water_g, kettle)—os mililitros de água de extração, ou gramas de água em densidade unitária. Opcionalmente envie brew_ratio (aliases ratio, coffee_to_water, water_ratio, brew, strength_ratio)—partes de água por uma parte de café; o padrão é dezesseis quando omitido, o ponto de partida habitual do filtro de um para dezesseis. Ambos os campos podem chegar como números JSON ou strings numéricas. water_volume zero ou negativo falha com invalid_input e mensagem de que o volume de água deve ser positivo; esse é o caminho de erro documentado e não é cobrado. brew_ratio zero ou negativo falha da mesma forma porque um ratio não positivo dividiria a água em uma dose sem sentido ou infinita. water_volume ausente, strings vazias, valores não finitos e magnitudes absolutas acima de um trilhão também falham a validação. Em caso de sucesso o corpo ecoa water_volume e brew_ratio, devolve coffee_mass como o quociente em gramas, ratio_label como string de exibição do tipo 1:16, formula como a identidade em forma fechada e message como resumo em uma linha em inglês adequado à interface.

Onde uma calculadora de ratio de café se paga

Baristas domésticos que extraem na xícara favorita precisam de uma dose que acompanhe o volume da chaleira ao passar de uma xícara de dia de semana de duzentos e cinquenta mililitros para um Chemex de fim de semana de quinhentos sem reescrever uma planilha. Treinadores de cafeteria imprimem cartões de ratio para a equipe e querem uma checagem ao vivo quando o cliente pede uma xícara mais forte ou mais fraca enquanto o volume do tanque de lote permanece fixo. Prefira esta capacidade quando você já souber o volume de água e o ratio café-água; não é conversor de xícaras para gramas por densidade, nem calculadora de miligramas de cafeína, nem o auxiliar inverso que parte do peso do grão para achar a água. Sites de receitas e apps móveis guardam estilos como números de ratio e chamam um conversor mínimo ao renderizar um guia de extração a partir do volume de água informado pelo usuário, preenchendo coffee_mass no cartão antes da lista de compras. Como a implementação é parse puro de tier A, cada chamada bem-sucedida custa o preço base publicado US$ 0,002 sem tokens de modelo nem rede externa. Tarefas falhas com invalid_input não consomem saldo pré-pago, o que mantém baratos scripts exploratórios quando você envia de propósito volume zero para verificar o tratamento de erros. Fixe o coffee_mass arredondado nos testes e você obtém gramas reproduzíveis para chaleiras, landings e workers de borda sem montar uma planilha própria.