Calculadora de proteína bruta

Nitrogênio negativo é rejeitado como invalid_input para que um erro de sinal nunca vire uma alegação de proteína negativa.

O que a proteína bruta significa e por que o laboratório multiplica o nitrogênio por um fator

Esta calculadora aplica o fator positivo que você enviar e usa 6.25 quando omite conversion_factor, alinhada à convenção AOAC de alimentos mistos.

Contrato de entrada, forma da resposta e comportamento de erro

Quando você envia um fator, ele deve ser um número finito estritamente maior que zero, porque um multiplicador nitrogênio-proteína nulo ou negativo inventaria um percentual de proteína sem sentido. Nitrogênio zero é válido e devolve proteína bruta zero. Faça POST de um corpo JSON com nitrogen_percent, um número finito não negativo para o teor de nitrogênio medido como percentual. Os aliases nitrogen, n_percent, n, nitrogen_pct e kjeldahl_n são aceitos quando o cliente já usa um nome mais curto. conversion_factor é opcional e vale 6.25 por padrão, o fator de Jones para alimentos mistos; os aliases factor, jones_factor, protein_factor e n_factor são aceitos. Cada campo pode chegar como número JSON ou como string numérica que interpreta como valor finito; campos ausentes, strings vazias e valores não finitos falham com invalid_input nomeando o campo. Se nitrogen_percent for negativo, o tratador rejeita a requisição com uma mensagem de que o percentual de nitrogênio é negativo, alinhado à regra laboratorial de que um ensaio não pode reportar menos que zero de nitrogênio e a clientes de API que tratam sucesso vazio e falha dura de forma distinta para cobrança e retentativas. Em sucesso o corpo ecoa nitrogen_percent e conversion_factor arredondados, define crude_protein como o produto arredondado a doze casas decimais, unit como o sinal de porcentagem, formula como crude_protein igual a nitrogen_percent vezes conversion_factor, e method como kjeldahl_jones para que roteadores posteriores ramifiquem sem cheirar formas. Uma verificação clássica de sala de aula é nitrogen_percent dezesseis com o fator padrão, que produz crude_protein cem. Combine a resposta com a sua própria conversão de umidade ou matéria seca se ainda precisar de proteína em base seca; este endpoint apenas multiplica.

Onde uma API de proteína bruta justifica o uso

Moinhos de ração e nutricionistas convertem o nitrogênio Kjeldahl de grãos, farelo de oleaginosas e rações mistas recebidos em proteína bruta para formulação de menor custo sem rederivar 6.25 em cada planilha. Equipes de rótulo e de QA conferem que o N% de laboratório vezes o fator do método coincide com a alegação de proteína na ficha de especificação antes de um lote sair. Validação falha não consome saldo. Plantas de laticínios que reportam proteína com um fator de Jones 6.38 podem enviar esse conversion_factor de forma explícita em vez de embutir uma segunda fórmula em um script sob medida. Ferramentas de sala de aula e de prova precisam de um oráculo determinístico que marque uma entrada de nitrogênio negativa como invalid_input em vez de imprimir em silêncio uma proteína negativa que um avaliador defeituoso poderia tratar como sucesso. Como a implementação é parse pura 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 o crude_protein arredondado nos testes e você obtém percentuais de proteína reproduzíveis para tarefas, plugins LMS e workers de borda sem levantar um CAS de química. Prefira esta capacidade quando você já tiver o percentual de nitrogênio e só precisar do produto de Jones; se a origem ainda for um título de digestão úmida, termine primeiro o cálculo de N% Kjeldahl e então chame este endpoint.