Kaffee-Ratio-Rechner

Nicht positive Wasservolumina scheitern mit invalid_input statt eine Dosis zu erfinden, sodass eine Nullfüllung des Kessels nie zu einem stillen Null-Gramm-Shot wird.

Wie Wasservolumen und Kaffee-zu-Wasser-Ratio zur Kaffeemasse werden

In der Küchenpraxis liegt die Wasserdichte bei Raumtemperatur nahe genug an einem Gramm pro Milliliter, dass Milliliter Kesselwasser Gramm Wasser entsprechen; der Rechner meldet coffee_mass daher in Gramm, wenn Sie water_volume in Millilitern messen. Das Ratio zu ändern ändert die Tassenstärke ohne die Bechergeometrie: ein Sud fünfzehn zu eins schmeckt voller als siebzehn zu eins bei gleicher Mahlung und Kontaktzeit. Dieser Endpoint modelliert weder Extraktionsausbeute, gelöste Gesamtfeststoffe, Bloomzeit noch Mahlgrad—er skaliert nur Kaffee zu Wasser, damit Sie die Waage vor dem Mahlen einstellen können. Die Identität lautet coffee_mass gleich water_volume geteilt durch brew_ratio, mit stabilem Zwölf-Dezimalstellen-Runden, damit Goldens und API-Clients über JavaScript-Runtimes übereinstimmen.

Eingabevertrag, Standardwerte, Antwortform und Fehler

Beispiel: zweihundertachtundachtzig Milliliter Wasser beim Standard-Ratio sechzehn ergeben achtzehn Gramm Kaffeepulver. Senden Sie einen JSON-Body mit einer erforderlichen endlichen positiven Zahl: water_volume (Aliasse water, water_ml, volume, water_g, kettle)—die Milliliter Brühwasser oder Gramm Wasser bei Einheitsdichte. Optional senden Sie brew_ratio (Aliasse ratio, coffee_to_water, water_ratio, brew, strength_ratio)—Wasserteile pro einem Teil Kaffee; der Standard ist sechzehn, wenn weggelassen, der übliche Filterstart von eins zu sechzehn. Beide Felder können als JSON-Zahlen oder numerische Strings ankommen. Null oder negatives water_volume scheitert mit invalid_input und der Meldung, dass das Wasservolumen positiv sein muss; das ist der dokumentierte Fehlerpfad und wird nicht berechnet. Null oder negatives brew_ratio scheitert ebenso, weil ein nicht positives Ratio Wasser in eine sinnlose oder unendliche Dosis teilen würde. Fehlendes water_volume, leere Strings, nicht endliche Werte und absolute Beträge über einer Billion scheitern ebenfalls an der Validierung. Bei Erfolg spiegelt der Body water_volume und brew_ratio wider, liefert coffee_mass als Quotient in Gramm, ratio_label als Anzeigezeichenkette wie 1:16, formula als geschlossene Identität und message als einzeilige englische Zusammenfassung für die UI.

Wo ein Kaffee-Ratio-Rechner seinen Nutzen zeigt

Heimbraistas, die in ihre Lieblingstasse brühen, brauchen eine Dosis, die dem Kesselvolumen folgt, wenn sie von einer zweihundertfünfzig-Milliliter-Wochentagstasse zu einem fünfhundert-Milliliter-Wochenend-Chemex wechseln, ohne eine Tabelle umzuschreiben. Café-Trainer drucken Ratio-Karten fürs Personal und wollen einen Live-Check, wenn ein Gast eine stärkere oder schwächere Tasse wünscht, während das Batch-Tankvolumen fest bleibt. Bevorzugen Sie diese Fähigkeit, wenn Sie Wasservolumen und Kaffee-zu-Wasser-Ratio bereits kennen; es ist kein Tassen-zu-Gramm-Dichte-Tool, kein Koffein-Milligramm-Rechner und nicht der inverse Helfer, der vom Bohnengewicht aus das Wasser sucht. Rezeptseiten und mobile Apps speichern Stil-Presets als Ratio-Zahlen und rufen einen kleinen Konverter auf, wenn sie eine Brühanleitung aus einem vom Nutzer eingegebenen Wasservolumen rendern und coffee_mass auf der Karte vor der Einkaufsliste füllen. Weil die Implementierung reines Parse-Tier-A ist, kostet jeder erfolgreiche Aufruf den veröffentlichten Basispreis $0.002 ohne Modell-Tokens und ohne ausgehendes Netzwerk. Fehlgeschlagene Tasks mit invalid_input verbrauchen kein Prepaid-Guthaben, was explorative Skripte günstig hält, wenn Sie absichtlich ein Nullvolumen senden, um die Fehlerbehandlung zu prüfen. Verankern Sie das gerundete coffee_mass in Tests und Sie erhalten reproduzierbare Gramm für Kessel, Landingpages und Edge-Worker, ohne eine eigene Tabelle aufzusetzen.