Mise à l'échelle cocktail par portions

Des portions d'origine ou cibles non positives échouent avec invalid_input car un rendement nul ou négatif ne définit pas une échelle pertinente. Le chemin est une arithmétique pure et déterministe—sans réseau, sans graines aléatoires, sans dépendance à l'horloge—ainsi l'exécuteur gratuit du navigateur et l'API prépayée renvoient le même JSON après l'arrondi décimal fixe à chaque appel.

Ce que signifie l'échelle de lot de cocktails et pourquoi les ratios restent fixes

Il fixe le facteur égal à target divisé par servings, puis renvoie à la fois un tableau scaled plat et un tableau ingredients qui associe chaque quantité d'origine à sa valeur mise à l'échelle. Les feuilles de cours, tableurs de programme de bar et katas de programmation peuvent affirmer le même JSON arrondi car l'arithmétique ne dépend jamais de l'horloge ni de données externes.

Comment appeler l'API : entrées, forme de la réponse et validation

Les names facultatifs n'apparaissent au niveau supérieur que lorsqu'au moins un libellé a été fourni ; les champs facultatifs sont omis plutôt que fixés à null. Envoyez un corps JSON avec amounts comme tableau obligatoire de nombres finis—ou une chaîne séparée par des virgules sur les formulaires texte—plus servings pour le rendement d'origine et target pour le nombre de boissons souhaité. Servings et target doivent tous deux être finis et strictement supérieurs à zéro ; les valeurs nulles, négatives et non numériques échouent avec invalid_input et ne sont jamais facturées. Les names facultatifs (alias labels, ingredients) alignent des libellés texte avec chaque quantité dans le même ordre ; les libellés en trop ou manquants sont complétés ou tronqués pour que le nombre de lignes corresponde toujours. Les valeurs absolues doivent rester dans la limite d'un billion, et la longueur de la liste est plafonnée pour qu'un Worker termine rapidement. En cas de succès la réponse renvoie les amounts arrondis, les valeurs scaled, factor, count, servings, target, les lignes ingredients avec index amount et scaled plus name le cas échéant, formula, message et steps ordonnés. Une validation échouée—amounts vides, nombres non finis, servings ou target manquants, ou portions non positives—renvoie invalid_input. Le tarif est un forfait $0.002 par requête réussie avec l'unité item. Préférez des nombres plutôt que des chaînes d'unités préformatées dans amounts ; placez les unités dans le champ facultatif names afin que soixante et gin (ml) restent séparés et lisibles par machine.

Conseils pratiques pour fêtes, bars, limites et outils connexes

Gardez les unités cohérentes dans la liste : si les lignes de spiritueux sont en millilitres, gardez aussi agrumes et sirops en millilitres, et réservez dashes ou pièces uniquement aux lignes qui utilisent vraiment ces unités. Des valeurs positives proches de zéro sont autorisées pour de minuscules lignes d'amers si votre fiche les utilise, mais les portions d'origine ou cibles à zéro sont toujours rejetées. Cette page cible les recherches de calculateur d'échelle de lot de cocktails, mise à l'échelle de recette de cocktail pour une fête ou multiplicateur de boisson en carafe ; ce n'est ni un convertisseur d'unités, ni un estimateur d'ABV, ni un système complet d'inventaire de bar. Les vérifications aller-retour sont simples : recalculez à la main chaque amount multiplié par factor et confirmez l'égalité avec l'entrée scaled publiée au même arrondi à douze décimales, et confirmez qu'en changeant seulement target chaque ligne s'échelonne proportionnellement. Rejetez toujours les portions non positives dans les formulaires client avant l'envoi lorsque c'est possible ; l'API renverra tout de même un message clair invalid_input si zéro ou un nombre d'invités négatif passe, car diviser par un rendement non positif ou viser zéro boisson n'est pas un lot pertinent. Pour mettre à l'échelle une fiche monoverre classique, fixez servings à 1 et target au nombre de verres que vous prévoyez de servir—huit pour un dîner, vingt-quatre pour une petite réception. Pour une recette déjà écrite comme un shake de deux boissons, fixez servings à 2 et target au total de service afin que le facteur soit dérivé correctement sans double comptage. Préférez les outils cook frères lorsque vous avez besoin d'une échelle générale de recette de cuisine ou d'un coût par portion, puis utilisez ce endpoint lorsque l'intention est le rendement du cocktail. Les tâches en échec qui renvoient invalid_input ne consomment pas le solde prépayé, ce qui maintient les scripts d'exploration peu coûteux lorsque l'on envoie volontairement target zéro.