ForHosting KIT · Outils pour développeurs

Calculez une note pondérée à partir d'un barème

Ce calculateur de barème combine les pourcentages obtenus pour chaque critère selon les pondérations exactes prévues pour l'évaluation.

● BetaGratuit · dans votre navigateur
Utilisez-le depuis WebAPIE-mailTelegramApp bientôt

Il contrôle la validité de chaque note et de chaque poids, refuse le calcul si leur somme n'atteint pas 100 %, puis renvoie le total pondéré et une note classique de A à F. La contribution de chaque critère figure également dans le résultat, afin que vous puissiez vérifier le calcul, l'expliquer à l'élève ou l'intégrer à un processus de notation sans dépendre d'une formule de tableur.

Préparez les notes et les pondérations des critères

Saisissez un enregistrement pour chaque critère du barème. Chacun doit comporter un nom explicite, une note exprimée en pourcentage de 0 à 100 et un poids également compris entre 0 et 100. Par exemple, un critère de recherche noté 92 et représentant 30 % du devoir reçoit la note 92 et le poids 30. Convertissez les critères exprimés en points avant l'envoi : 18 points obtenus sur 20 correspondent à 90 %. Conservez toutes les lignes du barème, y compris celles dont le poids est nul lorsqu'elles restent utiles pour formuler une appréciation sans influencer la note. Les noms apparaissent dans le résultat avec les valeurs d'origine et leur contribution pondérée ; des libellés précis et stables facilitent donc les contrôles ultérieurs. Le calculateur accepte jusqu'à 100 critères et rejette les noms vides, les valeurs non numériques, les infinis ainsi que les nombres hors limites, plutôt que de deviner l'intention de la personne ayant conçu l'évaluation.

Comprenez le calcul pondéré

Pour chaque critère, le calculateur multiplie le pourcentage obtenu par son poids, puis divise le résultat par 100. Une note de 80 pour un critère pesant 25 % apporte donc 20 points pondérés. Toutes les contributions sont ensuite additionnées afin d'obtenir le total. Avant de fournir une réponse, l'outil vérifie que les poids saisis atteignent exactement 100 %. Ce contrôle est indispensable, car un barème incomplet peut tout de même produire un chiffre crédible tout en minorant ou en majorant la véritable note. Les infimes écarts liés à la représentation informatique des décimales sont tolérés, mais un total réellement insuffisant ou excessif provoque une erreur de saisie ; aucune normalisation silencieuse n'est appliquée. Les contributions et le total sont arrondis à deux décimales. Le barème fixe attribue A dès 90, B dès 80, C dès 70, D dès 60 et F en dessous de 60. Vérifiez que ces seuils correspondent bien au règlement utilisé dans votre établissement.

Exploitez et contrôlez le résultat

La réponse contient le total, la lettre obtenue, la somme confirmée des poids et la liste ordonnée des critères avec leur contribution pondérée. Ce niveau de détail va au-delà de la simple note finale. Le personnel enseignant peut montrer l'influence de chaque dimension, un système pédagogique peut archiver le calcul avec l'évaluation d'origine et une personne chargée du contrôle peut reproduire le résultat sans reconstituer les formules d'un tableur. L'algorithme étant déterministe et indépendant de tout service réseau, une même entrée valide produit toujours le même résultat JSON dans le navigateur comme via l'API. Considérez la lettre comme une indication fondée sur les seuils A–F annoncés, et non comme un substitut au règlement de votre établissement. Si votre formation emploie des signes plus ou moins, une validation binaire, une courbe, des critères supprimés ou un arrondi particulier, appliquez ces règles séparément. En cas d'erreur de pondération, corrigez le barème ou ajoutez les critères manquants au lieu de modifier les notes pour forcer un total de 100.

Finaliser la note d'un devoir

Combinez la recherche, l'analyse, l'exactitude et la présentation selon le barème validé, tout en conservant le détail des contributions.

Contrôler un processus pédagogique

Refusez un barème incorrect avant qu'une note pondérée soit inscrite dans un relevé ou un carnet de notes.

Expliquer une décision d'évaluation

Montrez aux élèves et aux personnes chargées du contrôle comment chaque critère intervient dans le pourcentage final et la lettre obtenue.

Quel est le coût d'une requête ?

Chaque requête API coûte $0.002. Le calculateur fonctionne également dans le navigateur pour l'offre de niveau A.

Que se passe-t-il si les poids ne totalisent pas 100 % ?

La requête renvoie une erreur de saisie. Le calculateur ne normalise jamais en silence des poids insuffisants ou excessifs.

Quel barème alphabétique est appliqué ?

La note est A à partir de 90, B à partir de 80, C à partir de 70, D à partir de 60 et F en dessous de 60.

Puis-je saisir des points plutôt que des pourcentages ?

Pas directement. Convertissez les points obtenus en pourcentage du maximum prévu pour chaque critère avant l'envoi.

Les critères de poids nul sont-ils acceptés ?

Oui. Ils figurent dans le détail, mais ajoutent zéro point au total.

Comment l'arrondi est-il effectué ?

Chaque contribution affichée et la note finale sont arrondies à deux décimales. La lettre est déterminée à partir du total arrondi.

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.

POSThttps://api.kit.forhosting.com/edu/rubric-score-aggregate

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é.

curl -X POST https://api.kit.forhosting.com/edu/rubric-score-aggregate \
  -H "Authorization: Bearer $KIT_KEY" \
  -H "Content-Type: application/json" \
  -d '{"criteria":[{"name":"Research","score":92,"weight":30},{"name":"Analysis","score":84,"weight":45},{"name":"Presentation","score":96,"weight":25}]}'
{
  "criteria": [
    {
      "name": "Research",
      "score": 92,
      "weight": 30
    },
    {
      "name": "Analysis",
      "score": 84,
      "weight": 45
    },
    {
      "name": "Presentation",
      "score": 96,
      "weight": 25
    }
  ]
}
{
  "task_id": "tsk_a1b2c3d4e5f6a1b2c3d4e5f6",
  "type": "edu.rubric_score_aggregate",
  "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.

par requête$0.002

Le prix est publié, sans tokens ni crédits. Une tâche qui échoue n’est pas facturée.

HTTPCodeSignification
401unauthorizedClé API absente ou invalide : vérifiez l’en-tête Authorization.
402insufficient_balanceSolde insuffisant : rechargez votre compte pour lancer cette tâche.
404unknown_typeType de tâche inconnu : vérifiez le champ type de votre requête.
429rate_limitedTrop de requêtes : ralentissez la cadence, puis réessayez.

Consulter la documentation complète du KIT →