Escale la receta con el ingrediente a mano

Este escalador de recetas por sobras toma cada cantidad numérica de su lista de ingredientes, elige una línea limitante (por índice o por nombre) y multiplica la lista entera por on_hand dividido entre la cantidad de esa línea en la receta. Las cantidades no positivas y un stock on_hand no positivo se rechazan con invalid_input en lugar de inventar un plato a cero. La ruta es aritmética determinista pura con redondeo decimal fijo, de modo que el ejecutor gratuito del navegador y la API prepago devuelven el mismo JSON cada vez que la invoca.

Qué significa escalar por sobras y cómo se construye el factor

El solver calcula un único factor compartido igual a on_hand dividido entre la cantidad de receta de la línea limitante, y luego multiplica cada cantidad por ese factor para que las proporciones relativas se mantengan. Aquí no se convierten unidades a propósito —use gramos o tazas tanto en la cantidad de receta como en on_hand para que el cociente sea adimensional— y los conversores cook hermanos pueden pasar tazas a gramos antes de escalar. Las hojas de aula y las coding kata pueden afirmar el mismo JSON redondeado porque la aritmética no depende del reloj ni de datos externos.

Cómo llamar a la API: campos, forma de la respuesta y errores

Envíe un cuerpo JSON con amounts como array obligatorio de números finitos positivos —o una cadena separada por comas en formularios de texto— más on_hand como la cantidad positiva del ingrediente limitante que realmente tiene. Elija la línea limitante con limiting_index (base cero; por defecto cero si se omite) o limiting_name, emparejado sin distinguir mayúsculas frente a la lista opcional names; si ambos se envían, gana el nombre para que los scripts identifiquen harina sin fijar posiciones. Names (alias labels, ingredients) son etiquetas paralelas opcionales rellenadas o recortadas al recuento de amounts. Los valores absolutos se mantienen dentro del límite publicado de un billón (escala corta estadounidense: un trillón), y la longitud de la lista está acotada para que un Worker termine pronto. En caso de éxito la respuesta devuelve amounts redondeados, scaled, factor, on_hand, limiting_index, limiting_name, recipe_amount de esa línea, count, names, filas ingredients con marca is_limiting, formula, message y steps ordenados. La validación fallida —amounts vacíos, números no finitos, cualquier cantidad de receta no positiva, on_hand no positivo, un índice fuera de rango o un limiting_name que no coincide— devuelve invalid_input y nunca se cobra. El precio es un $0.002 plano por petición correcta con unidad item. Prefiera números en lugar de cadenas de unidad dentro de amounts; ponga las unidades en names para que doscientos cincuenta y harina (g) queden separados y legibles en el array ingredients.

Consejos prácticos, búsquedas afines y cuándo usar otra herramienta

Los valores casi nulos y negativos se rechazan a propósito porque un stock o una línea de receta no positivos no definen una escala útil. Esta landing apunta a quien busca escalar receta por ingrediente a mano, calculadora de sobras limitantes o escala desde despensa; no es un conversor de unidades, ni un estimador nutricional, ni el escalador por raciones o multiplicador cuando ya conoce el número de comensales. Prefiera el escalador de recetas hermano cuando quiera factor dos para una doble tanda, y las herramientas de tazas a gramos cuando ficha y bolsa usen medidas distintas. Mantenga siempre on_hand y la cantidad de receta limitante en la misma unidad antes de enviar; mezclar tazas de harina con gramos de stock produce un factor matemáticamente válido pero culinariamente erróneo. Prefiera limiting_name cuando su lista es estable y limiting_index cuando construye amounts por programa sin etiquetas. Si varios ingredientes escasean, elija el cuello de botella real —la línea con menor cociente on_hand entre cantidad de receta— o ejecute la calculadora una vez por candidato y tome la tanda escalada mínima. Las tareas fallidas que devuelven invalid_input no consumen saldo prepago, lo que mantiene baratos los scripts exploratorios cuando los aprendices envían stock cero a propósito. Las comprobaciones de ida y vuelta son sencillas: recalcule a mano on_hand dividido entre la cantidad de receta limitante, multiplique cada línea y confirme que las entradas scaled publicadas coinciden dentro del redondeo a doce decimales, incluido que el valor scaled de la línea limitante iguale on_hand tras redondear.