Ratio grain-eau

Les grains inconnus échouent proprement avec invalid_input au lieu d'inventer.

Ce que le ratio grain-eau signifie en cuisine

Cette relation tient que vous mesuriez en tasses, millilitres ou louches, tant que grain et eau partagent la même unité de volume. Cette capacité encode ces ratios courants au feu pour quinoa, orge, farro, riz blanc et complet, basmati et jasmin, riz sauvage, boulgour, couscous, millet, amarante, sarrasin, freekeh, épeautre, baies de blé, flocons et flocons d'avoine coupés, polenta, kamut, teff, sorgho et baies de seigle, plus des alias du quotidien comme orge perlé, flocons d'avoine et semoule de maïs pour la polenta. Lorsque vous devez mettre un lot à l'échelle, envoyez grain_amount et l'outil multiplie l'eau par le même ratio pour qu'une casserole de deux tasses et un bac traiteur de dix tasses restent proportionnels.

Contrat d'entrée, champs de réponse et erreurs

Ancrez ces nombres déterministes dans vos tests pour que applications de recettes et widgets navigateur restent stables d'une version à l'autre. Envoyez un corps JSON avec le champ chaîne obligatoire grain — un nom connu tel que quinoa, orge ou farro. La correspondance ignore la casse ; espaces, tirets et underscores sont normalisés, et des alias comme orge perlé, riz complet et flocons d'avoine coupés résolvent vers les mêmes lignes que leurs clés canoniques. Le grain_amount optionnel est un nombre fini positif dans l'unité de volume que vous utilisez pour le grain sec ; lorsqu'il est présent, water_amount égale grain_amount multiplié par water_ratio. Le unit optionnel est une courte étiquette d'affichage (cup, ml, liter) reprise seulement dans le message — l'API ne convertit jamais entre systèmes d'unités. En succès le corps inclut grain comme nom lisible, grain_key comme identifiant stable en snake_case, water_ratio et water_parts comme parts numériques d'eau pour une de grain, ratio_label tel que 1:2, grain_parts toujours un, cook_minutes comme guide typique de frémissement, formula qui reformule la règle d'échelle et message pour l'interface. grain_amount, water_amount et unit n'apparaissent que si vous les avez fournis, afin que les clients qui omettent les optionnels ne voient jamais de null. grain manquant, chaînes vides, noms inconnus, grain_amount nul ou négatif et quantités non numériques échouent avec invalid_input et ne sont pas facturés. Exemple : grain quinoa renvoie water_ratio deux et ratio_label 1:2 ; le même grain avec grain_amount un et unit cup produit water_amount deux cup. Exemple : grain farro donne water_ratio deux virgule cinq ; grain barley donne trois.

Où une API de ratio grain-eau prouve sa valeur

Fiches de préparation food-service mettent farro ou orge à l'échelle pour banquets en envoyant grain_amount et en imprimant water_amount à côté de l'étiquette du bac. Parce que l'implémentation est pure parse de niveau A, chaque appel réussi coûte le prix de base publié $0.002 sans jetons de modèle ni réseau sortant.