Avaliação de funções

Em sucesso, devolve a string da expressão, a descrição do domínio real, in_domain true e o valor arredondado. Quando x cai fora do domínio—radicando negativo, argumento de log não positivo, denominador zero, potência indefinida—ainda devolve um payload estruturado com in_domain false e um motivo em linguagem clara em vez de inventar um resultado complexo ou infinito. Parâmetros malformados falham com invalid_input e não são cobrados.

O que significa avaliar uma função e quais famílias são suportadas

Escolher o kind e os coeficientes é o único passo de modelagem; o endpoint então substitui x, verifica o domínio e devolve um número arredondado estável ou o motivo de falha de domínio.

Contrato de entrada, formato da resposta e domínio

Coeficientes opcionais a, b, c, d, expoente n, base do log e coeffs do polinômio preenchem a família escolhida; padrões sensatos aplicam-se quando um coeficiente é opcional, de modo que linear só com x ainda significa f de x igual a x. Este desenho separa erros de parâmetros de falhas matemáticas de domínio: os primeiros são bugs do cliente; os segundos, momentos legítimos de ensino. Exemplo: kind linear, a igual a dois, b igual a um, x igual a três produz f de x igual a dois x mais um, domínio todos os reais, valor sete. Envie um corpo JSON com kind obrigatório do enum fixo e x finito obrigatório. Números podem chegar como números JSON ou strings decimais; valores não finitos, strings vazias, kinds desconhecidos, arrays de coeficientes vazios e bases de log ilegais lançam invalid_input nomeando o problema e não são cobrados. Em sucesso o corpo sempre inclui kind, x, expression, domain como string de intervalo, formula e in_domain. Quando in_domain é true, value está presente e arredondado a doze casas decimais para estabilidade de goldens entre runtimes. Quando in_domain é false—por exemplo raiz de x menos três em x igual a dois, ou uma recíproca em zero—value é omitido e reason explica a violação em linguagem clara para que a interface mostre um aviso de domínio em vez de resposta em branco. Exemplo: kind rational com denominador x menos um em x igual a um devolve in_domain false porque o denominador se anula. Combine o valor numérico com seu próprio código de gráfico se precisar de um esboço; este endpoint avalia em um único ponto e não emite gráficos nem simplificação simbólica em vários passos além dos campos expression e formula.

Onde uma API de avaliação de funções agrega valor

Salas de aula e plataformas de tutoria usam uma calculadora de avaliação de funções para que aprendizes confira valores substituídos em regras lineares, quadráticas, de raiz e de log sem escorregões aritméticos nem surpresas de números complexos. Geradores de provas e plugins LMS precisam de um oráculo determinístico que marque erros de domínio de forma distinta da aritmética errada, para que o autoavaliador possa dar crédito parcial ou sinalizar casos indefinidos. Validação falha não consome saldo. Cadernos de engenharia e ciência frequentemente inserem leituras de sensores ou parâmetros de projeto em modelos algébricos simples; chamar uma API parse pequena evita puxar um sistema completo de álgebra computacional para uma substituição de uma linha. Pipelines de dados que validam fórmulas digitadas pelo usuário podem chamar o endpoint com valores x candidatos para rejeitar amostras fora do domínio antes das etapas seguintes. Como a implementação é parse pura tier A, cada chamada bem-sucedida custa o preço base publicado US$ 0,002 sem tokens de modelo nem rede de saída. Mantenha requisições pequenas, fixe o valor arredondado e o flag in_domain nos testes, e obtenha resultados f de x reproduzíveis para lição de casa, plugins LMS e workers de borda sem levantar infraestrutura simbólica própria.