ForHosting KIT · Outils pour développeurs

Calculateur de note actuelle

Le pourcentage de note actuelle répond à une question précise : quel est votre niveau sur les travaux réellement notés ?

● BetaGratuit · dans votre navigateur

Lancer gratuitement Voir l’API

Utilisez-le depuis WebAPIE-mailTelegramApp bientôt

Saisissez les points obtenus et possibles de chaque activité, puis indiquez comme non noté tout travail sans résultat publié. Le calculateur retire ces activités en attente des deux totaux, additionne les points évalués et affiche le pourcentage obtenu à ce jour. Vous disposez ainsi d’un bilan clair sans assimiler un devoir futur ou non rendu à un zéro.

Relevez correctement les points du carnet

Commencez par les activités visibles dans votre carnet de notes et recopiez leurs points obtenus et possibles. Pour un quiz noté 18 sur 20, indiquez 18 et 20. Conservez une ligne par activité afin de pouvoir contrôler les données. Ne cochez « noté » que si l’enseignant a publié un résultat réel. Un projet valant 100 points mais dépourvu de résultat doit rester non noté et sera ignoré. N’inscrivez pas un zéro provisoire : un vrai zéro compte, tandis qu’une case vide ou en attente ne compte pas. Les noms restent facultatifs, mais des libellés comme « Quiz 1 » facilitent la détection des doublons et des oublis.

Comprenez le calcul fondé sur les points

Le calculateur additionne les points obtenus pour les lignes notées, additionne leurs points possibles, divise le premier total par le second et multiplie par 100. Ainsi, 18 sur 20 et 42 sur 50 donnent 60 sur 70, soit 85.71 pour cent avec deux décimales. Une ligne non notée est exclue du numérateur comme du dénominateur, afin de ne pas transformer un travail en attente en zéro. Le résultat représente une moyenne actuelle par points, qui peut différer de la note officielle. Certains cours pondèrent les examens, devoirs et la participation, suppriment une note ou accordent des bonus. Consultez alors le programme et vérifiez les totaux affichés.

Interprétez le résultat comme un instantané

Considérez ce pourcentage comme un état présent, et non comme une prévision de la note finale. Il décrit uniquement les éléments déjà évalués et peut évoluer fortement lorsqu’un examen ou un projet important est rendu. Comparez les totaux obtenus et possibles à votre carnet, puis examinez tout écart. Relancez le calcul à chaque nouvelle note, après une correction ou lorsque vous apprenez qu’une case vide correspond réellement à zéro. Les nombres d’activités notées et non notées permettent aussi de contrôler que la liste est complète. Pour planifier la suite, associez ce résultat aux coefficients et travaux restants du programme. Le calcul est déterministe, sans réseau, hasard ni horloge. Il est gratuit dans le navigateur et coûte $0.002 par requête API.

Cas d’usage

Faire le point aujourd’hui

Regroupez toutes les notes publiées sans compter les travaux qui n’ont pas encore été rendus.

Contrôler le total du carnet

Comparez les totaux de points obtenus et possibles avec ceux du système de votre cours.

Actualiser après une nouvelle note

Passez une activité en statut noté et recalculez immédiatement votre pourcentage actuel.

Questions fréquentes

Quels éléments sont ignorés ?

Toute activité marquée non notée est écartée, avec ses points obtenus et possibles.

Faut-il saisir zéro pour un devoir sans note ?

Uniquement si zéro est la note effectivement publiée. Laissez non noté ce qui attend encore une évaluation.

Les catégories pondérées sont-elles prises en charge ?

Non. Le calcul repose sur les points fournis ; des coefficients par catégorie peuvent produire une autre note officielle.

Les points obtenus peuvent-ils dépasser le maximum ?

Oui, car un enseignant peut accorder des points bonus sur une activité évaluée.

Comment le pourcentage est-il obtenu ?

Les points acquis sont divisés par les points possibles des travaux notés, puis multipliés par 100 et arrondis.

Quel est le prix d’une requête API ?

Le tarif de base est de $0.002 par requête. Le même calcul déterministe est gratuit dans le navigateur.

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/edu/current-grade-percentage

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/current-grade-percentage \
  -H "Authorization: Bearer $KIT_KEY" \
  -H "Content-Type: application/json" \
  -d '{"assignments":[{"name":"Quiz 1","earned":18,"possible":20,"graded":true},{"name":"Essay","earned":42,"possible":50,"graded":true},{"name":"Final project","possible":100,"graded":false}]}'

const res = await fetch("https://api.kit.forhosting.com/edu/current-grade-percentage", {
  method: "POST",
  headers: {
    "Authorization": `Bearer ${process.env.KIT_KEY}`,
    "Content-Type": "application/json"
  },
  body: JSON.stringify({
    "assignments": [
      {
        "name": "Quiz 1",
        "earned": 18,
        "possible": 20,
        "graded": true
      },
      {
        "name": "Essay",
        "earned": 42,
        "possible": 50,
        "graded": true
      },
      {
        "name": "Final project",
        "possible": 100,
        "graded": false
      }
    ]
  })
});
const { task_id } = await res.json();

import os, requests

res = requests.post(
    "https://api.kit.forhosting.com/edu/current-grade-percentage",
    headers={"Authorization": f"Bearer {os.environ['KIT_KEY']}"},
    json={
    "assignments": [
        {
            "name": "Quiz 1",
            "earned": 18,
            "possible": 20,
            "graded": true
        },
        {
            "name": "Essay",
            "earned": 42,
            "possible": 50,
            "graded": true
        },
        {
            "name": "Final project",
            "possible": 100,
            "graded": false
        }
    ]
},
)
task_id = res.json()["task_id"]

<?php
$res = file_get_contents("https://api.kit.forhosting.com/edu/current-grade-percentage", false, stream_context_create([
  "http" => [
    "method"  => "POST",
    "header"  => "Authorization: Bearer " . getenv("KIT_KEY") . "\r\nContent-Type: application/json",
    "content" => '{"assignments":[{"name":"Quiz 1","earned":18,"possible":20,"graded":true},{"name":"Essay","earned":42,"possible":50,"graded":true},{"name":"Final project","possible":100,"graded":false}]}',
  ],
]));
$task = json_decode($res, true);

body := bytes.NewBufferString(`{"assignments":[{"name":"Quiz 1","earned":18,"possible":20,"graded":true},{"name":"Essay","earned":42,"possible":50,"graded":true},{"name":"Final project","possible":100,"graded":false}]}`)
req, _ := http.NewRequest("POST", "https://api.kit.forhosting.com/edu/current-grade-percentage", 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

{
  "assignments": [
    {
      "name": "Quiz 1",
      "earned": 18,
      "possible": 20,
      "graded": true
    },
    {
      "name": "Essay",
      "earned": 42,
      "possible": 50,
      "graded": true
    },
    {
      "name": "Final project",
      "possible": 100,
      "graded": false
    }
  ]
}

Exemple de réponse

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

Limites

max_items 500

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.

Consulter la documentation complète du KIT →