Pourcentage boulanger en poids

Un poids de farine invalide ou un pourcentage négatif échoue avec invalid_input au lieu d'inventer une masse.

Contrat d'entrée, forme de la réponse et comportement d'erreur

Le poids de farine doit être strictement positif car la farine est la base à cent pour cent ; une farine nulle ou négative rendrait le système indéfini. Le pourcentage boulanger doit être non négatif ; zéro renvoie un poids d'ingrédient nul, correct pour un optionnel omis. L'arrondi utilise douze décimales pour des goldens stables entre runtimes sans changer la précision de balance. Une validation échouée n'est jamais facturée. Envoyez en POST un corps JSON avec deux nombres finis obligatoires : flour_weight (alias flour, flour_g, flour_mass, total_flour, flour_wt)—la masse totale de farine dans l'unité que vous utiliserez pour l'ingrédient, en général des grammes—et bakers_pct (alias percent, pct, baker_percent, bakers_percent, percentage, bp)—le pourcentage boulanger de cet ingrédient par rapport à la farine. Les deux champs acceptent des nombres JSON ou des chaînes numériques strictes ; chaînes vides, valeurs non finies et texte libre échouent avec invalid_input en nommant le champ. En cas de succès le corps renvoie flour_weight et bakers_pct arrondis, ingredient_weight comme flour_weight multiplié par bakers_pct sur cent, formula comme l'identité en forme fermée et message comme un résumé d'une ligne adapté à l'interface. Exemple : flour_weight mille et bakers_pct soixante-cinq donnent ingredient_weight six cent cinquante. Le tarif est un forfait $0.002 par requête réussie avec unité item.

Où la conversion du pourcentage boulanger est utile

Les boulangers amateurs qui mettent à l'échelle une formule publiée de levain ou de pizza sur une balance de cuisine convertissent chaque ligne de pourcent en grammes une fois la charge de farine choisie, évitant les erreurs de multiplication mentale qui décalent l'hydratation de dizaines de grammes. Les fiches de production de boulangerie partent d'un objectif quotidien de farine et développent chaque ingrédient—sel, malt, huile, preferment—à partir des pourcentages boulangers pour que les pétrins reçoivent des tickets de pesée exacts. Préférez cette capacité lorsque vous connaissez déjà la farine totale et le pourcent boulanger d'un ingrédient ; ce n'est pas un équilibreur multi-lignes de formule, ni un convertisseur de densité tasses vers grammes, ni une rétro-ingénierie d'hydratation depuis la pâte finie. Les formateurs culinaires enseignent le système en montrant qu'un passage de cinq cents à huit cents grammes de farine multiplie les autres poids par le même facteur tandis que les pourcentages restent fixes ; une API déterministe offre des vérifications instantanées aux élèves. Les applications de recettes et les backends de kits repas stockent souvent les formules de pâte comme cartes de pourcentages pour un scaling sans unité figée, puis appellent un endpoint de conversion pour afficher la liste d'achats ou l'interface de balance. 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 une farine nulle pour vérifier la gestion d'erreur.