Scalatore ricette

Un fattore di zero è rifiutato con invalid_input perché azzerare ogni riga cancellerebbe la ricetta invece di scalarla. Il percorso è aritmetica deterministica pura — senza rete, senza semi casuali, senza dipendenza dall’orologio di parete — così l’esecutore gratuito del browser e l’API prepagata restituiscono lo stesso JSON dopo un arrotondamento decimale fisso a ogni chiamata.

Cosa significa scalare una ricetta e quando usare un moltiplicatore

Lo strumento accetta un elenco non vuoto di numeri finiti come amounts, nomi paralleli opzionali come etichette, e restituisce sia un array scaled piatto sia un array ingredients che abbina ogni quantità originale al valore scalato. I fogli di aula e le coding kata possono asserire lo stesso JSON arrotondato perché l’aritmetica non dipende mai dall’orologio né da dati esterni.

Come chiamare l’API: modalità fattore, modalità porzioni e la risposta

Se compaiono factor e target, vince il factor esplicito così gli script che hanno già calcolato il rapporto non vengono sovrascritti. Invii un corpo JSON con amounts come array obbligatorio di numeri finiti — o una stringa separata da virgole nei form di testo — più factor o target secondo la regola pubblicata di richiederne uno. Factor (alias multiplier, scale, times) è il coefficiente di scala esplicito applicato a ogni quantità. Target (alias to_servings, target_servings, for) è un conteggio di porzioni desiderato; quando usa target senza factor, il solver imposta factor uguale a target diviso servings, e servings predefinito è uno se omette il conteggio originale. I valori assoluti devono restare entro il limite pubblicato di un trilione (scala corta), e la lunghezza dell’elenco è limitata affinché un Worker finisca in fretta. In caso di successo la risposta restituisce amounts arrotondati, scaled, factor, count, mode (multiplier o servings), servings e target opzionali, names, righe ingredients, formula, message e steps ordinati. La validazione fallita — amounts vuoti, numeri non finiti, factor e target assenti, un divisore servings originale zero, o un factor di zero — restituisce invalid_input e non viene mai addebitata. Il prezzo è un $0.002 piatto per richiesta riuscita con unità item e prezzo unitario marginale zero.

Consigli pratici, errori di fattore zero, limiti e ricerche correlate

Rifiuti sempre un fattore di zero nei form client prima dell’invio quando può; l’API lancerà comunque un messaggio chiaro invalid_input se uno zero sfugge, perché azzerare ogni ingrediente non è una scala significativa. Scalando per porzioni, mantenga il conteggio originale diverso da zero — da quattro a sei è un percorso comune e produce factor 1.5 — e ricordi che servings predefinito è uno quando si invia solo target, utile per ricette scritte a persona. Preferisca numeri anziché stringhe di unità preformattate dentro amounts; metta le unità nel campo opzionale names così duecentocinquanta e farina (g) restano separati. Le attività fallite che restituiscono invalid_input non consumano saldo prepagato, il che mantiene economici gli script esplorativi quando gli apprendisti inviano di proposito factor zero.