Valutazione di funzioni

In caso di successo restituisce la stringa dell’espressione, la descrizione del dominio reale, in_domain true e il valore arrotondato. Quando x esce dal dominio—radicando negativo, argomento di log non positivo, denominatore zero, potenza indefinita—restituisce comunque un payload strutturato con in_domain false e un motivo in linguaggio chiaro invece di inventare un risultato complesso o infinito. I parametri malformati falliscono con invalid_input e non vengono addebitati.

Cosa significa valutare una funzione e quali famiglie sono supportate

Scegliere kind e coefficienti è l’unico passo di modellazione; l’endpoint sostituisce x, controlla il dominio e restituisce un numero arrotondato stabile o il motivo di fallimento di dominio.

Contratto di ingresso, forma della risposta e dominio

I coefficienti opzionali a, b, c, d, esponente n, base del log e coeffs del polinomio completano la famiglia scelta; si applicano default ragionevoli quando un coefficiente è opzionale, così linear solo con x significa ancora f di x uguale a x. Esempio: kind linear, a uguale a due, b uguale a uno, x uguale a tre produce f di x uguale a due x più uno, dominio tutti i reali, valore sette. Invii un corpo JSON con kind obbligatorio dall’enum fisso e x finito obbligatorio. I numeri possono arrivare come numeri JSON o stringhe decimali; valori non finiti, stringhe vuote, kind sconosciuti, array di coefficienti vuoti e basi di log illegali generano invalid_input indicando il problema e non vengono addebitati. In successo il corpo include sempre kind, x, expression, domain come stringa di intervallo, formula e in_domain. Quando in_domain è false—ad esempio radice di x meno tre in x uguale a due, o una reciproca in zero—value è omesso e reason spiega la violazione in linguaggio chiaro così l’interfaccia può mostrare un avviso di dominio invece di una risposta vuota. Questo progetto separa errori di parametri da fallimenti matematici di dominio: i primi sono bug del client; i secondi, momenti didattici legittimi. Esempio: kind rational con denominatore x meno uno in x uguale a uno restituisce in_domain false perché il denominatore si annulla. Abbini il valore numerico al proprio codice di grafico se serve uno schizzo; questo endpoint valuta in un solo punto e non emette grafici né semplificazione simbolica a più passi oltre ai campi expression e formula.

Dove un’API di valutazione di funzioni conviene

Aule e piattaforme di tutoraggio usano una calcolatrice di valutazione di funzioni affinché chi impara possa verificare valori sostituiti in regole lineari, quadratiche, di radice e di log senza scivoloni aritmetici né sorprese di numeri complessi. Generatori di esami e plugin LMS necessitano di un oracolo deterministico che segni gli errori di dominio in modo diverso dall’aritmetica sbagliata, così il correttore automatico può assegnare credito parziale o segnalare casi indefiniti. La validazione fallita non consuma saldo. I taccuini di ingegneria e scienza spesso inseriscono letture di sensori o parametri di progetto in semplici modelli algebrici; chiamare una piccola API parse evita di trascinare un intero sistema di algebra computazionale per una sostituzione di una riga. Le pipeline di dati che validano formule inserite dall’utente possono chiamare l’endpoint con valori x candidati per scartare campioni fuori dominio prima dei passi successivi. Poiché l’implementazione è parse pura di livello A, ogni chiamata riuscita costa il prezzo base pubblicato $0.002 senza token di modello né rete in uscita. Mantenga le richieste piccole, fissi il valore arrotondato e il flag in_domain nei test, e otterrà risultati f di x riproducibili per compiti, plugin LMS e worker edge senza erigere infrastruttura simbolica propria.