Moyenne d'examen de classe
Collez les notes d'examen d'une classe et obtenez en une fois la moyenne, la note la plus haute, la plus basse et l'étendue : cinq notes allant de 68 à 91 donnent une moyenne de 78,6 et une étendue de 23 points. Gratuit dans votre navigateur.
- Gratuit
- Fonctionne dans votre navigateur
- Sans inscription
- Vos données restent sur votre appareil
Lancer gratuitement
Exemple résolu
- Scores
- 72, 85, 91, 68, 77
- Quantité
- 5
- Sum
- 393
- Moyenne
- 78,6
- Le plus élevé
- 91
Après chaque partiel, quiz ou examen final, les enseignants et assistants ont besoin de la moyenne de la classe en quelques secondes, pas d'une session tableur. Ce calculateur de moyenne d'examen de classe prend une liste de notes d'élèves, calcule la moyenne arithmétique et signale aussi la note la plus haute, la plus basse et l'étendue entre elles, afin que vous voyiez tendance centrale et dispersion en une seule réponse. Utilisez-le lorsque la moyenne de classe est un signal pédagogique — décisions de courbe, seuils de rattrapage et réunions avec les familles — sans déployer une suite statistique complète pour quatre indicateurs.
Ce que signifient la moyenne d'examen de classe, le max, le min et l'étendue
La moyenne d'examen de classe est la moyenne arithmétique de toutes les notes que vous soumettez : additionnez toutes les notes, divisez par le nombre d'élèves (ou de tentatives) de la liste, et vous obtenez la valeur centrale que la plupart des systèmes de notation appellent « moyenne de classe ». Ce seul chiffre répond à « comment le groupe s'en est-il sorti globalement ?
», mais ne montre pas à lui seul si tout le monde s'est concentré près de la moyenne ou si quelques résultats extrêmes l'ont tirée vers le haut ou le bas. Le maximum et le minimum comblent ce vide : la note la plus haute est la valeur maximale de la liste, la plus basse est le minimum, et l'étendue est simplement maximum moins minimum.
Une petite étendue signifie une performance serrée ; une grande étendue signifie des résultats dispersés et peut motiver une analyse d'items, une courbe ou un soutien renforcé pour les élèves en bas. Ce calculateur se limite délibérément à ces quatre résumés orientés enseignement — moyenne, maximum, minimum, étendue — plus le décompte et la somme pour l'audit. Il n'invente pas de mentions littérales, d'écarts types ni de mélanges pondérés par catégorie ; ce sont d'autres intentions de recherche et d'autres outils.
Les notes peuvent être sur n'importe quelle échelle numérique finie (pourcent 0–100, points sur 50, totaux de grille) ; le calcul est le même. Lorsque toutes les notes sont identiques, l'étendue vaut zéro et la moyenne égale cette note. Lorsque la liste n'a qu'une note, moyenne, maximum et minimum coïncident et l'étendue vaut zéro.
Cas d’usage
Résumé de classe post-examen pour enseignants
Collez les notes d'examen de la section après correction pour obtenir moyenne, max, min et étendue pour le tableau, l'annonce LMS ou le message aux familles en une étape.
Questions fréquentes
Comment calculer la moyenne d'examen de la classe ?
Envoyez un tableau scores non vide de nombres finis.
Qu'est-ce que l'étendue des notes d'examen ?
L'étendue est la note la plus haute moins la plus basse de votre liste. Une étendue plus grande indique une plus grande dispersion des résultats autour de la moyenne de classe.
Les notes doivent-elles être entre 0 et 100 ?
Non. Tout nombre fini dans la magnitude prise en charge est accepté, donc échelles en pourcent, examens sur N points et totaux de grille fonctionnent.
Que se passe-t-il si j'envoie une liste de notes vide ?
Une moyenne de classe exige au moins une note finie ; les listes vides ne sont pas facturées.
Que révèle une grande étendue des notes ?
Elle montre que les résultats sont dispersés au lieu de se regrouper autour de la moyenne. Un grand écart entre la note la plus haute et la plus basse peut justifier une analyse des questions, une courbe ou un soutien pour les élèves en difficulté.
Outils associés
Pour les développeurs — accès API
Tout sur cette page est disponible par programmation. Cette section s'adresse aux équipes qui veulent l'intégrer à leurs systèmes ; les autres peuvent simplement utiliser l'outil ci-dessus.
Endpoint
Authentification par jeton Bearer : un seul POST met la tâche en file d’attente, et le résultat vous parvient par webhook ou lien signé.
Appeler depuis votre stack
curl -X POST https://api.kit.forhosting.com/edu/class-exam-average \
-H "Authorization: Bearer $KIT_KEY" \
-H "Content-Type: application/json" \
-d '{"scores":[72,85,91,68,77]}'const res = await fetch("https://api.kit.forhosting.com/edu/class-exam-average", {
method: "POST",
headers: {
"Authorization": `Bearer ${process.env.KIT_KEY}`,
"Content-Type": "application/json"
},
body: JSON.stringify({
"scores": [
72,
85,
91,
68,
77
]
})
});
const { task_id } = await res.json();import os, requests
res = requests.post(
"https://api.kit.forhosting.com/edu/class-exam-average",
headers={"Authorization": f"Bearer {os.environ['KIT_KEY']}"},
json={
"scores": [
72,
85,
91,
68,
77
]
},
)
task_id = res.json()["task_id"]<?php
$res = file_get_contents("https://api.kit.forhosting.com/edu/class-exam-average", false, stream_context_create([
"http" => [
"method" => "POST",
"header" => "Authorization: Bearer " . getenv("KIT_KEY") . "\r\nContent-Type: application/json",
"content" => '{"scores":[72,85,91,68,77]}',
],
]));
$task = json_decode($res, true);body := bytes.NewBufferString(`{"scores":[72,85,91,68,77]}`)
req, _ := http.NewRequest("POST", "https://api.kit.forhosting.com/edu/class-exam-average", body)
req.Header.Set("Authorization", "Bearer "+os.Getenv("KIT_KEY"))
req.Header.Set("Content-Type", "application/json")
res, _ := http.DefaultClient.Do(req)Exemple de requête
{
"scores": [
72,
85,
91,
68,
77
]
}Exemple de réponse
{
"task_id": "tsk_a1b2c3d4e5f6a1b2c3d4e5f6",
"type": "edu.class_exam_average",
"status": "queued",
"_links": {
"result": "/tasks/tsk_…/result"
}
}L’API est asynchrone : chaque appel renvoie un task_id immédiatement, puis vous interrogez l’état à raison d’une requête par seconde.
Tarifs
Le prix est publié, sans tokens ni crédits. Une tâche qui échoue n’est pas facturée.
Erreurs
| HTTP | Code | Signification |
|---|---|---|
401 | unauthorized | Clé API absente ou invalide : vérifiez l’en-tête Authorization. |
402 | insufficient_balance | Solde insuffisant : rechargez votre compte pour lancer cette tâche. |
404 | unknown_type | Type de tâche inconnu : vérifiez le champ type de votre requête. |
429 | rate_limited | Trop de requêtes : ralentissez la cadence, puis réessayez. |
Notes techniques
Collez les notes brutes d'un export de carnet, d'une liste de classe ou du presse-papiers ; le moteur de parse pur valide chaque entrée comme nombre fini, rejette les listes vides et renvoie un contrat JSON stable que vous pouvez figer dans des tests ou brancher dans un plugin LMS.
Ce que signifient la moyenne d'examen de classe, le max, le min et l'étendue
Les listes vides sont invalides : il n'y a pas de moyenne de personne, et l'API échoue avec invalid_input au lieu de renvoyer une moyenne zéro creuse qui pourrait tromper un tableau de bord.
Contrat d'entrée, forme de la réponse et règles de validation
Il n'est pas exigé que les notes soient entre 0 et 100 : l'outil accepte toute magnitude finie dans une borne sûre, de sorte que les examens en points et les grilles échelonnées fonctionnent sans prétraitement. Envoyez en POST un objet JSON avec le champ obligatoire scores : un tableau non vide de nombres finis, au moins une entrée et au plus cinq cents. Les alias acceptés pour la même liste incluent exam_scores, grades, marks, values et numbers, afin que les exports de carnet avec des noms de colonnes différents se mappent encore correctement. Chaque élément peut être un nombre JSON ou une chaîne numérique ; les valeurs non finies, chaînes vides et jetons non numériques échouent avec invalid_input en nommant le mauvais index. Vous pouvez aussi passer scores comme une seule chaîne séparée par des virgules ou des espaces lorsqu'un formulaire texte est plus pratique qu'un tableau JSON. En cas de succès le corps renvoie le tableau scores nettoyé, count (n), la somme de toutes les notes, mean (somme divisée par n), highest, lowest et range (maximum moins minimum), plus une courte chaîne formula et l'étiquette method class_exam_average pour les clients qui journalisent quel endpoint a produit la ligne. Scores manquants, tableau vide, plus de cinq cents entrées ou un corps qui n'est pas un objet lèvent invalid_input et ne sont pas facturés. Associez ce contrat à vos propres bandes de mentions ou courbes si vous avez besoin d'une sortie catégorielle ; ce endpoint ne rapporte que des statistiques descriptives de classe.
Où une API de moyenne d'examen de classe apporte une vraie valeur
Les enseignants collent les notes après un contrôle de chapitre pour publier la moyenne de classe et indiquer le haut et le bas en toute transparence, sans ouvrir une feuille complète de formules du carnet. Les centres de tutorat et programmes péri-scolaires suivent les moyennes de quiz semaine après semaine avec un oracle déterministe qui ne dérive jamais entre le contrôle gratuit du navigateur et le rapport automatisé. Les plugins LMS et portails de devoirs appellent le même module pur pour montrer aux élèves la « moyenne de classe à ce jour » à côté des notes personnelles sans livrer une bibliothèque statistique à chaque client. Les coordinateurs de département envoient par lots les listes de chaque section via l'API pour comparer moyennes et étendues entre sections parallèles du même cours avant de décider si une courbe commune est équitable. Comme l'implémentation est parse de niveau A pur, chaque appel réussi coûte le prix de base publié $0.002 sans jetons de modèle ni réseau sortant ; une validation échouée ne consomme pas le solde.
Cas d'intégration
Comparaison départementale multi-sections
Envoyez les notes de chaque section parallèle via l'API et comparez moyennes et étendues avant de choisir une courbe commune ou une politique de rattrapage.
Tableaux de bord LMS et tutorat
Affichez la moyenne de classe en direct et la dispersion à côté des notes individuelles avec un endpoint parse déterministe aligné sur le widget gratuit du navigateur.
Questions techniques
Combien coûte le calculateur de moyenne d'examen de classe ?
L'outil navigateur est gratuit. Les requêtes API utilisent le solde KIT prépayé à $0.002 par appel réussi ; une entrée invalide n'est pas facturée.