Media esame di classe

Incolli i voti grezzi da un'esportazione del registro, da un elenco della classe o dagli appunti; il motore di parse puro convalida ogni voce come numero finito, rifiuta elenchi vuoti e restituisce un contratto JSON stabile che Lei può fissare nei test o integrare in un plugin LMS.

Cosa significano la media d'esame di classe, il massimo, il minimo e l'intervallo

Gli elenchi vuoti non sono validi: non esiste media di nessuno, e l'API fallisce con invalid_input invece di restituire una media zero vuota che potrebbe fuorviare una dashboard.

Contratto di input, forma della risposta e regole di validazione

Non è richiesto che i voti stiano tra 0 e 100: lo strumento accetta qualsiasi magnitudine finita entro un limite sicuro, così esami a punti e rubriche scalate funzionano senza pre-elaborazione. Invii in POST un oggetto JSON con il campo obbligatorio scores: un array non vuoto di numeri finiti, almeno una voce e al massimo cinquecento. Gli alias accettati per lo stesso elenco includono exam_scores, grades, marks, values e numbers, così le esportazioni del registro con nomi di colonna diversi si mappano ancora bene. Ogni elemento può essere un numero JSON o una stringa numerica; valori non finiti, stringhe vuote e token non numerici falliscono con invalid_input indicando l'indice errato. Lei può anche passare scores come unica stringa separata da virgole o spazi quando un modulo di testo è più comodo di un array JSON. In caso di successo il corpo ripete l'array scores ripulito, count (n), la somma di tutti i voti, mean (somma divisa per n), highest, lowest e range (massimo meno minimo), più una breve stringa formula e l'etichetta method class_exam_average per i client che registrano quale endpoint ha prodotto la riga. Scores mancanti, array vuoto, più di cinquecento voci o un corpo che non è un oggetto sollevano invalid_input e non vengono fatturati. Abbini questo contratto alle Sue fasce di giudizio o curve se serve un'uscita categoriale; questo endpoint riporta solo statistiche descrittive di classe.

Dove un'API di media d'esame di classe genera valore reale

I docenti incollano i voti dopo una verifica di unità per pubblicare la media di classe e indicare alto e basso con trasparenza, senza aprire un intero foglio di formule del registro. I centri di tutoraggio e i programmi extrascolastici seguono le medie dei quiz settimana per settimana con un oracolo deterministico che non deriva mai tra il controllo gratuito del browser e il report automatico. Plugin LMS e portali compiti chiamano lo stesso modulo puro per mostrare agli studenti la «media di classe finora» accanto ai voti personali senza distribuire una libreria statistica a ogni client. I coordinatori di dipartimento inviano in batch gli elenchi di ciascuna sezione tramite l'API per confrontare medie e intervalli tra sezioni parallele dello stesso corso prima di decidere se una curva comune è equa. Poiché l'implementazione è parse di tier A puro, ogni chiamata riuscita costa il prezzo base pubblicato $0.002 senza token di modello né rete in uscita; la validazione fallita non consuma saldo.