Calculadora de media de examen

Pegue las marcas en bruto desde una exportación del libro de notas, un listado del grupo o el portapapeles; el motor de análisis puro valida cada entrada como número finito, rechaza listas vacías y devuelve un contrato JSON estable que puede fijar en pruebas o integrar en un complemento LMS.

Qué significan la media de examen de clase, la máxima, la mínima y el rango

Las listas vacías no son válidas: no hay media de nadie, y la API falla con invalid_input en lugar de devolver una media cero vacía que podría engañar a un panel.

Contrato de entrada, forma de la respuesta y reglas de validación

No se exige que las notas estén en 0–100: la herramienta acepta cualquier magnitud finita dentro de un límite seguro, de modo que exámenes por puntos y rúbricas escaladas funcionan sin preprocesado. Envíe por POST un objeto JSON con el campo obligatorio scores: un arreglo no vacío de números finitos, al menos una entrada y como máximo quinientas. Los alias aceptados para la misma lista incluyen exam_scores, grades, marks, values y numbers, de modo que las exportaciones del libro de notas con distintos nombres de columna sigan mapeando bien. Cada elemento puede ser un número JSON o una cadena numérica; valores no finitos, cadenas vacías y tokens no numéricos fallan con invalid_input nombrando el índice erróneo. También puede pasar scores como una sola cadena separada por comas o espacios cuando un formulario de texto sea más cómodo que un arreglo JSON. En caso de éxito el cuerpo repite el arreglo scores limpio, count (n), la suma de todas las notas, mean (suma dividida por n), highest, lowest y range (máxima menos mínima), más una cadena formula breve y la etiqueta method class_exam_average para clientes que registran qué endpoint produjo la fila. Scores ausentes, un arreglo vacío, más de quinientas entradas o un cuerpo que no sea un objeto provocan invalid_input y no se facturan. Combine este contrato con sus propias bandas de letra o curvas si necesita salida categórica; este endpoint solo informa estadísticas descriptivas de la clase.

Dónde una API de media de examen de clase aporta valor real

Los docentes pegan las notas tras un control de unidad para publicar la media de la clase y señalar la máxima y la mínima con transparencia, sin abrir una hoja completa de fórmulas del libro de notas. Los centros de tutoría y los programas extraescolares siguen las medias de cuestionarios semana a semana con un oráculo determinista que nunca diverge entre la comprobación gratuita del navegador y el informe automatizado. Los complementos LMS y los portales de deberes llaman al mismo módulo puro para mostrar a los estudiantes la «media de la clase hasta ahora» junto a sus notas personales sin repartir una biblioteca estadística a cada cliente. Los coordinadores de departamento envían por lotes las listas de cada sección a través de la API para comparar medias y rangos entre grupos paralelos del mismo curso antes de decidir si una curva común es justa. Como la implementación es parse de nivel A puro, cada llamada exitosa cuesta el precio base publicado $0.002 sin tokens de modelo ni red saliente; la validación fallida no consume saldo.