ForHosting KIT · Éducation

Calculateur de notes

Saisissez des notes avec leur coefficient pour obtenir la moyenne pondérée : 80 et 90 au même coefficient donnent 85. Ou passez à l'option examen final pour savoir quelle note il vous reste à obtenir pour atteindre votre objectif. Gratuit dans votre navigateur.

Gratuit
Fonctionne dans votre navigateur
Sans inscription
Vos données restent sur votre appareil

Lancer gratuitement Voir l’API

Utilisez-le depuis WebAPIE-mailTelegramApp bientôt

Exemple résolu

Si vous saisissez

Mode de calcul: Moyenne pondérée

Vous obtenez

Moyenne: 85
Pondération totale: 2
Éléments pris en compte: 2

moyenne pondérée gratuit en ligne

Deux questions : votre situation et ce qu'il vous faut

Presque toutes les questions de notes sont de deux sortes. La première consiste à connaître votre situation actuelle : chaque interrogation, devoir ou examen a une note et un coefficient, et la moyenne pondérée multiplie chaque note par son coefficient, additionne les résultats et divise par le total des coefficients. Deux notes de 80 et 90 au même coefficient donnent 85. La seconde consiste à planifier : avec la moyenne visée et le poids de l'examen final, quelle note faut-il y obtenir ? La calculatrice résout ce calcul et affiche aussi votre moyenne actuelle.

Les coefficients et les erreurs courantes

Les coefficients sont relatifs : vous pouvez utiliser des pourcentages, des points ou de simples multiplicateurs, à condition de garder le même type pour toutes les notes. Une erreur fréquente consiste à faire la moyenne sans coefficients, ce qui donne à une petite interrogation autant de poids qu'un gros examen. Une autre consiste à oublier que, pour la note nécessaire, le coefficient du final s'ajoute à ceux déjà saisis. Chaque coefficient doit être supérieur à zéro, et la liste accepte jusqu'à 50 notes.

Éléments, poids et validation

En mode average le tableau items doit contenir de 1 à 50 entrées, et un poids total nul déclenche une erreur de division par zéro. Tout élément malformé, champ requis manquant ou valeur hors plage échoue proprement avant ou pendant la somme, jamais par un plantage non typé.

Cas d’usage

Suivi des notes d'un cours

Combinez interrogations, devoirs et examens avec leurs poids en une seule moyenne pondérée courante.

Questions fréquentes

Comment la moyenne pondérée est-elle calculée ?

Somme de chaque score multiplié par son poids, divisée par le total des poids ; les poids doivent être supérieurs à zéro.

Quelle note me faut-il à l'examen final pour atteindre mon objectif ?

Choisissez l'option examen final et indiquez la note globale visée, le coefficient du final et les notes déjà obtenues. La calculatrice résout la note que doit apporter le final et affiche aussi votre moyenne actuelle.

Les coefficients doivent-ils totaliser 100 ?

Non. La somme de chaque note multipliée par son coefficient est divisée par le total des coefficients saisis : des coefficients de 1 et 1 donnent la même moyenne que 50 et 50.

Un coefficient peut-il valoir zéro ?

Non. Chaque coefficient doit être supérieur à zéro, et un coefficient nul ou négatif est refusé. Les notes peuvent être n'importe quel nombre jusqu'à un million en valeur absolue.

Combien de notes peut-on saisir ?

De 1 à 50 avec l'option moyenne. Avec l'option examen final, la liste des notes déjà obtenues est facultative : vous pouvez aussi partir de votre seul objectif et du coefficient du final.

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

POSThttps://api.kit.forhosting.com/dev/grade-calculator

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/dev/grade-calculator \
  -H "Authorization: Bearer $KIT_KEY" \
  -H "Content-Type: application/json" \
  -d '{"mode":"average"}'

const res = await fetch("https://api.kit.forhosting.com/dev/grade-calculator", {
  method: "POST",
  headers: {
    "Authorization": `Bearer ${process.env.KIT_KEY}`,
    "Content-Type": "application/json"
  },
  body: JSON.stringify({
    "mode": "average"
  })
});
const { task_id } = await res.json();

import os, requests

res = requests.post(
    "https://api.kit.forhosting.com/dev/grade-calculator",
    headers={"Authorization": f"Bearer {os.environ['KIT_KEY']}"},
    json={
    "mode": "average"
},
)
task_id = res.json()["task_id"]

<?php
$res = file_get_contents("https://api.kit.forhosting.com/dev/grade-calculator", false, stream_context_create([
  "http" => [
    "method"  => "POST",
    "header"  => "Authorization: Bearer " . getenv("KIT_KEY") . "\r\nContent-Type: application/json",
    "content" => '{"mode":"average"}',
  ],
]));
$task = json_decode($res, true);

body := bytes.NewBufferString(`{"mode":"average"}`)
req, _ := http.NewRequest("POST", "https://api.kit.forhosting.com/dev/grade-calculator", 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

{
  "mode": "average"
}

Exemple de réponse

{
  "task_id": "tsk_a1b2c3d4e5f6a1b2c3d4e5f6",
  "type": "dev.grade_calculator",
  "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

par requête$0.002

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

Calcule une moyenne pondérée d'éléments notés, ou en mode final_needed la note que vous devez obtenir à un examen final pondéré pour atteindre une note globale souhaitée.

Deux modes sélectionnés par le champ mode

En mode average il prend un tableau items de 1 à 50 entrées, chacune un objet avec un score numérique et un weight positif, et renvoie la moyenne pondérée : la somme de score multiplié par weight divisée par le poids total. L'exemple — deux éléments de 80 et 90 au poids 1 en mode average — renvoie une moyenne de 85. dev.grade_calculator bifurque selon un champ mode requis. La réponse inclut average, total_weight et items_count. En mode final_needed vous fournissez une note globale souhaitée et le final_weight de l'examen restant, plus un tableau items facultatif de notes déjà obtenues ; il résout la note que vous devez avoir à ce final. La formule est (desired * (somme_des_poids + final_weight) - somme_des_score_fois_poids) / final_weight, et la réponse renvoie desired, final_weight, needed et current_average.

Éléments, poids et validation

Chaque élément est validé : score doit être un nombre fini dont la valeur absolue n'excède pas 1e6, et weight doit être un nombre fini strictement supérieur à zéro, de sorte qu'un poids nul ou négatif est rejeté par une erreur typée invalid_input. En mode final_needed items est facultatif — une liste omise et un tableau vide sont traités de façon identique, puisqu'un formulaire déclaratif écarte les listes facultatives vides — de sorte qu'en l'absence de notes antérieures la note needed est simplement la note souhaitée. desired doit être fini et final_weight doit être fini et supérieur à zéro.

Arrondi, current_average et planification

Une valeur needed supérieure au maximum qu'un final peut accorder vous indique que l'objectif est hors de portée ; une valeur needed négative signifie que l'objectif est déjà acquis. En mode final_needed la réponse porte aussi current_average : la moyenne pondérée des notes déjà saisies, ou null lorsqu'aucun élément antérieur n'a été fourni, de sorte qu'un étudiant voit à la fois où il en est et ce que le final exige.

Cas d'intégration

Planification de l'examen final

Utilisez final_needed pour indiquer à un étudiant la note exacte requise au final afin d'atteindre une note cible.

Automatisation du carnet de notes

Appelez l'API par étudiant pour ajouter une colonne de moyenne pondérée ou de note requise à toute une classe.

Questions techniques

Quelle est la différence entre les deux modes ?

average renvoie la moyenne pondérée de vos éléments ; final_needed résout la note requise à un final pondéré pour atteindre une note globale souhaitée.

Ai-je besoin de notes antérieures pour le mode final_needed ?

Non. items y est facultatif ; sans notes antérieures la note needed égale la note souhaitée et current_average vaut null.

Comment l'arrondi est-il contrôlé ?

Le champ decimals (0 à 4, 2 par défaut) arrondit les résultats half-up à partir de la valeur brute, et non via toFixed.

Qu'est-ce qui déclenche une erreur ?

Un poids non positif, un poids total nul, un score hors plage ou un champ requis manquant renvoie invalid_input. API à partir de $0.002.

Consulter la documentation complète du KIT →

Lancer gratuitement

Exemple résolu

Deux questions : votre situation et ce qu'il vous faut

Les coefficients et les erreurs courantes

Éléments, poids et validation

Cas d’usage

Suivi des notes d'un cours

Questions fréquentes

Outils associés

Pour les développeurs — accès API

Endpoint

Appeler depuis votre stack

Exemple de requête

Exemple de réponse

Tarifs

Erreurs

Notes techniques

Deux modes sélectionnés par le champ mode

Éléments, poids et validation

Arrondi, current_average et planification

Cas d'intégration

Planification de l'examen final

Automatisation du carnet de notes

Questions techniques

merci