Calculateur de ratio café

Les volumes d'eau non positifs échouent avec invalid_input au lieu d'inventer une dose, si bien qu'un remplissage nul de bouilloire ne devient jamais un shot silencieux de zéro gramme.

Comment le volume d'eau et le ratio café-eau deviennent une masse de café

En cuisine pratique, la densité de l'eau à température ambiante est assez proche d'un gramme par millilitre pour que les millilitres d'eau de bouilloire égalent des grammes d'eau, de sorte que le calculateur rapporte coffee_mass en grammes lorsque vous mesurez water_volume en millilitres. Ce endpoint ne modélise ni le rendement d'extraction, ni les solides dissous totaux, ni le temps de bloom, ni la granulométrie—il ne fait qu'échelonner le café à l'eau pour que vous puissiez régler la balance avant de moudre. L'identité est coffee_mass égal à water_volume divisé par brew_ratio, avec un arrondi stable à douze décimales pour que goldens et clients API coïncident entre runtimes JavaScript.

Contrat d'entrée, valeurs par défaut, forme de réponse et erreurs

Exemple : deux cent quatre-vingt-huit millilitres d'eau au ratio par défaut seize donnent dix-huit grammes de café moulu. Envoyez un corps JSON avec un nombre fini positif obligatoire : water_volume (alias water, water_ml, volume, water_g, kettle)—les millilitres d'eau d'infusion, ou grammes d'eau à densité unitaire. Envoyez optionnellement brew_ratio (alias ratio, coffee_to_water, water_ratio, brew, strength_ratio)—parts d'eau pour une part de café ; la valeur par défaut est seize si omis, le point de départ habituel du filtre de un pour seize. Les deux champs peuvent arriver en nombres JSON ou en chaînes numériques. Un water_volume nul ou négatif échoue avec invalid_input et un message indiquant que le volume d'eau doit être positif ; c'est le chemin d'erreur documenté et il n'est pas facturé. Un brew_ratio nul ou négatif échoue de la même façon parce qu'un ratio non positif diviserait l'eau en une dose absurde ou infinie. water_volume manquant, chaînes vides, valeurs non finies et magnitudes absolues supérieures à un billion échouent aussi la validation. En cas de succès le corps répète water_volume et brew_ratio, renvoie coffee_mass comme quotient en grammes, ratio_label comme chaîne d'affichage du type 1:16, formula comme l'identité en forme fermée et message comme résumé d'une ligne en anglais adapté à l'interface.

Où un calculateur de ratio café justifie sa place

Les baristas à domicile qui infusent dans leur tasse favorite ont besoin d'une dose qui suit le volume de la bouilloire lorsqu'ils passent d'une tasse de semaine de deux cent cinquante millilitres à un Chemex de week-end de cinq cents sans réécrire un tableur. Les formateurs de café impriment des fiches de ratio pour le personnel et veulent une vérification en direct lorsqu'un client demande une tasse plus forte ou plus douce alors que le volume du réservoir de lot reste fixe. Préférez cette capacité lorsque vous connaissez déjà le volume d'eau et le ratio café-eau ; ce n'est pas un outil tasses-vers-grammes par densité, ni un calculateur de milligrammes de caféine, ni l'aide inverse qui part du poids des grains pour trouver l'eau. Les sites de recettes et applications mobiles stockent des styles comme nombres de ratio et appellent un petit convertisseur lorsqu'ils rendent un guide d'infusion à partir du volume d'eau saisi par l'utilisateur, en remplissant coffee_mass sur la fiche avant la liste de courses. Parce que 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. Les tâches en échec avec invalid_input ne consomment pas le solde prépayé, ce qui garde les scripts exploratoires peu coûteux lorsque vous envoyez volontairement un volume nul pour vérifier la gestion d'erreur. Ancrez le coffee_mass arrondi dans les tests et vous obtenez des grammes reproductibles pour bouilloires, pages d'atterrissage et workers de bord sans dresser un tableur à vous.