Calculadora de carboidratos líquidos

Esta calculadora de carboidratos líquidos aceita gramas de carboidratos totais, de fibra alimentar e de álcoois de açúcar (polióis) e devolve um valor determinístico net_carbs com a fórmula reescrita para exibição. Total não positivo, fibra ou polióis negativos e combinações impossíveis em que a fibra mais os álcoois superam o total falham com invalid_input em vez de inventar um resultado negativo.

O que significam os carboidratos líquidos e como a fórmula é aplicada

A aritmética é deliberadamente simples: net_carbs é igual a total_carbs menos fiber menos sugar_alcohols, com cada quantidade em gramas por porção ou por entrada de alimento. Este endpoint implementa exatamente essa convenção de consumo, sem estimar índice glicêmico, sem converter unidades e sem adivinhar campos ausentes do rótulo. Se a fibra mais os álcoois superarem o total, a combinação não pode vir de um rótulo coerente, então a tarefa falha com invalid_input em vez de devolver um líquido negativo que confunda logs e painéis.

Contrato de entrada, formato da resposta e comportamento de erro

Exemplo: vinte e cinco gramas de carboidratos totais, oito de fibra e cinco de álcoois de açúcar resultam em doze gramas de carboidratos líquidos. Exemplo sem polióis: quarenta de total, dez de fibra e zero de álcoois resultam em trinta gramas líquidos. A validação falha não é cobrada. A capacidade não consulta produtos, não raspa bancos de dados nem ajusta meias contagens de marca de certos polióis; se o seu protocolo subtrai apenas metade dos álcoois de açúcar, aplique esse fator antes de chamar ou depois de receber a cifra líquida bruta. Envie por POST um corpo JSON com três campos obrigatórios: total_carbs, fiber e sugar_alcohols. Cada um pode chegar como número JSON ou como string numérica; booleanos, strings vazias, NaN e Infinity falham com invalid_input nomeando o campo. Aliases são aceitos por conveniência de transporte: carbs, carbohydrate, total_carbohydrate, carbohydrate_g e carbs_g mapeiam para total_carbs; fiber_g, dietary_fiber, fibre e fibre_g para fiber; sugar_alcohols_g, polyols, polyol_g e sugar_alcohol para sugar_alcohols. Em caso de sucesso o corpo devolve os valores limpos de total_carbs, fiber e sugar_alcohols, o net_carbs calculado, uma string formula breve e unit em g. Combine o resultado com sua própria interface de diário, cache de códigos de barras ou escalador de receitas; este endpoint só realiza a aritmética em gramas.

Onde uma calculadora de carboidratos líquidos agrega valor de verdade

Aplicativos de planejamento de refeições e coaches cetogênicos usam uma calculadora de carboidratos líquidos para que o usuário cole as cifras do rótulo e permaneça sob um orçamento diário de líquidos sem erros de planilha. Agregadores de restaurantes e delivery normalizam os macros do fornecedor em carboidratos líquidos para filtros como menos de dez gramas líquidos, o que exige uma única função determinística em vez de código ad hoc em cada plataforma. Ferramentas de educação sobre glicose contínua e diabetes costumam ensinar a leitura de rótulos mostrando total versus líquido lado a lado; uma API compartilhada mantém idênticos a demo da sala de aula e o backend de produção. Como a implementação é pure parse de nível A, cada chamada bem-sucedida custa o preço base publicado US$ 0,002, sem tokens de modelo e sem rede de saída. Mantenha as requisições pequenas, fixe net_carbs esperado nos testes e você obtém resultados reproduzíveis para clientes móveis, workers serverless e importadores em lote sem montar o seu próprio banco de dados nutricional.