Evaluación de funciones

Si acierta, devuelve la expresión, la descripción del dominio real, in_domain true y el valor redondeado. Cuando x queda fuera del dominio—radicando negativo, argumento de log no positivo, denominador cero, potencia indefinida—sigue devolviendo un payload estructurado con in_domain false y un motivo en lenguaje claro en lugar de inventar un resultado complejo o infinito. Los parámetros mal formados fallan con invalid_input y no se facturan.

Qué significa evaluar una función y qué familias se admiten

Elegir el kind y los coeficientes es el único paso de modelado; el endpoint sustituye x, comprueba el dominio y devuelve un número redondeado estable o el motivo de fallo de dominio.

Contrato de entrada, forma de la respuesta y dominio

Los coeficientes opcionales a, b, c, d, exponente n, base del log y coeffs del polinomio completan la familia elegida; hay valores por defecto razonables cuando un coeficiente es opcional, de modo que linear solo con x sigue significando f de x igual a x. Este diseño separa errores de parámetros de fallos matemáticos de dominio: los primeros son fallos del cliente; los segundos, momentos didácticos legítimos. Ejemplo: kind linear, a igual a dos, b igual a uno, x igual a tres produce f de x igual a dos x más uno, dominio todos los reales, valor siete. Envíe un cuerpo JSON con kind obligatorio del enum fijo y x finito obligatorio. Los números pueden llegar como números JSON o cadenas decimales; valores no finitos, cadenas vacías, kinds desconocidos, arrays de coeficientes vacíos y bases de log ilegales lanzan invalid_input nombrando el problema y no se facturan. En éxito el cuerpo siempre incluye kind, x, expression, domain como cadena de intervalo, formula e in_domain. Cuando in_domain es true, value está presente y redondeado a doce decimales para estabilidad de goldens entre runtimes. Cuando in_domain es false—por ejemplo raíz de x menos tres en x igual a dos, o una recíproca en cero—value se omite y reason explica la violación en lenguaje claro para que la interfaz muestre un aviso de dominio en lugar de una respuesta en blanco. Ejemplo: kind rational con denominador x menos uno en x igual a uno devuelve in_domain false porque el denominador se anula. Combine el valor numérico con su propio código de graficado si necesita un boceto; este endpoint evalúa en un solo punto y no emite gráficos ni simplificación simbólica en varios pasos más allá de los campos expression y formula.

Dónde aporta valor una API de evaluación de funciones

Las aulas y las plataformas de tutoría usan una calculadora de evaluación de funciones para que el alumnado compruebe valores sustituidos en reglas lineales, cuadráticas, de raíz y de log sin fallos aritméticos ni sorpresas de números complejos. Los generadores de exámenes y los plugins LMS necesitan un oráculo determinista que marque los errores de dominio de forma distinta a la aritmética incorrecta, de modo que el autocorrector pueda dar crédito parcial o señalar casos indefinidos. La validación fallida no consume saldo. Los cuadernos de ingeniería y ciencia a menudo insertan lecturas de sensores o parámetros de diseño en modelos algebraicos sencillos; llamar a una API parse pequeña evita arrastrar un sistema de álgebra computacional completo para una sustitución de una línea. Las canalizaciones de datos que validan fórmulas introducidas por el usuario pueden llamar al endpoint con valores x candidatos para rechazar muestras fuera de dominio antes de los pasos posteriores. Como la implementación es parse pura de nivel A, cada llamada exitosa cuesta el precio base publicado $0.002 sin tokens de modelo ni red de salida. Mantenga las peticiones pequeñas, fije en las pruebas el valor redondeado y el indicador in_domain, y obtendrá resultados f de x reproducibles para deberes, plugins LMS y workers en el borde sin levantar infraestructura simbólica propia.