Évaluation de fonctions

En cas de succès, elle renvoie la chaîne d’expression, la description du domaine réel, in_domain true et la valeur arrondie. Lorsque x sort du domaine—radicande négatif, argument de log non positif, dénominateur nul, puissance indéfinie—elle renvoie encore un payload structuré avec in_domain false et une raison en langage clair au lieu d’inventer un résultat complexe ou infini. Les paramètres mal formés échouent avec invalid_input et ne sont pas facturés.

Ce que signifie évaluer une fonction et quelles familles sont prises en charge

Choisir le kind et les coefficients est la seule étape de modélisation ; le endpoint substitue alors x, vérifie le domaine et renvoie un nombre arrondi stable ou la raison d’échec de domaine.

Contrat d’entrée, forme de la réponse et signalement du domaine

Les coefficients optionnels a, b, c, d, exposant n, base du log et coeffs du polynôme complètent la famille choisie ; des valeurs par défaut raisonnables s’appliquent lorsqu’un coefficient est optionnel, de sorte que linear avec seulement x signifie encore f de x égale x. Cette conception sépare les erreurs de paramètres des échecs mathématiques de domaine : les premières sont des bugs client ; les seconds, des moments pédagogiques légitimes. Exemple : kind linear, a égale deux, b égale un, x égale trois donne f de x égale deux x plus un, domaine tous les réels, valeur sept. Envoyez un corps JSON avec kind obligatoire de l’enum fixe et x fini obligatoire. Les nombres peuvent arriver comme nombres JSON ou chaînes décimales ; valeurs non finies, chaînes vides, kinds inconnus, tableaux de coefficients vides et bases de log illégales déclenchent invalid_input en nommant le problème et ne sont pas facturés. En succès le corps inclut toujours kind, x, expression, domain sous forme d’intervalle, formula et in_domain. Lorsque in_domain est true, value est présent et arrondi à douze décimales pour la stabilité des goldens entre runtimes. Lorsque in_domain est false—par exemple racine de x moins trois en x égale deux, ou une réciproque en zéro—value est omis et reason explique la violation en langage clair pour que l’interface affiche un avertissement de domaine au lieu d’une réponse vide. Exemple : kind rational avec dénominateur x moins un en x égale un renvoie in_domain false car le dénominateur s’annule. Associez la valeur numérique à votre propre code de tracé si vous avez besoin d’un croquis ; ce endpoint n’évalue qu’en un point et n’émet ni graphiques ni simplification symbolique multi-étapes au-delà des champs expression et formula.

Où une API d’évaluation de fonctions se justifie

Les salles de classe et les plateformes de tutorat utilisent une calculatrice d’évaluation de fonctions pour que les apprenants vérifient des valeurs substituées dans des règles linéaires, quadratiques, de racine et de log sans glissements arithmétiques ni surprises de nombres complexes. Les générateurs d’examens et les plugins LMS ont besoin d’un oracle déterministe qui marque les erreurs de domaine autrement que l’arithmétique fausse, afin que le correcteur automatique puisse accorder un crédit partiel ou signaler les cas indéfinis. Une validation échouée ne consomme pas le solde. Les carnets d’ingénierie et de science branchent souvent des lectures de capteurs ou des paramètres de conception dans de simples modèles algébriques ; appeler une petite API parse évite de tirer un système complet d’algèbre computationnelle pour une substitution d’une ligne. Les pipelines de données qui valident des formules saisies par l’utilisateur peuvent appeler le endpoint avec des x candidats pour rejeter les échantillons hors domaine avant les étapes suivantes. Comme l’implémentation est pure parse de niveau A, chaque appel réussi coûte le prix de base publié $0.002 sans jetons de modèle ni réseau sortant. Gardez les requêtes petites, figez la valeur arrondie et le drapeau in_domain dans les tests, et vous obtenez des résultats f de x reproductibles pour les devoirs, les plugins LMS et les workers en bordure sans déployer votre propre infrastructure symbolique.