Calculateur de note d'examen

Une note brute d’examen ne devient une lettre qu’après division par le maximum de points possibles et application d’une échelle de pourcentages publiée. Enseignants, élèves, greffons LMS et correcteurs de devoirs ont besoin de la même conversion : le pourcentage est égal à score divisé par maximum fois cent, puis une lettre selon les seuils américains standard de dix points. L’arithmétique est entièrement déterministe, s’exécute gratuitement dans votre navigateur et est disponible via l’API à $0.002 par requête réussie, sans modèle de langage ni carnet de notes externe sur le chemin critique.

Ce qu’est une lettre d’examen et pourquoi l’échelle de dix points s’impose

Le pourcentage est égal à score divisé par maximum fois cent.

Contrat d’entrée, formule, arrondi et comportement d’erreur

L’option decimals est un entier de 0 à 6 qui pilote l’arrondi half-up du pourcentage renvoyé ; la valeur par défaut est 2 décimales pour qu’un résultat tel que 87.5 corresponde aux affichages habituels du carnet. La lettre est attribuée à partir de ce pourcentage arrondi afin que le nombre que vous affichez et la lettre que vous affichez ne puissent pas diverger : 89.995 à 2 décimales devient 90.00, lettre A. Un maximum nul ou négatif échoue aussi, car diviser par un plafond non positif n’est pas un pourcentage d’examen. Une note négative échoue. Une validation en échec n’est pas facturée. Envoyez par POST un corps JSON avec deux nombres finis obligatoires : score, les points obtenus, et maximum, les points possibles. Chaque champ peut arriver comme nombre JSON ou comme chaîne numérique. Score accepte aussi les alias earned, points, raw et raw_score ; maximum accepte max, max_score, total et out_of, afin que les scripts qui parlent déjà ainsi n’aient pas besoin d’une étape de rename. Champs manquants, chaînes vides et valeurs non finies échouent avec invalid_input en nommant le problème. Une note qui dépasse le maximum échoue avec invalid_input afin qu’un bonus au-dessus du plafond publié ne ressemble jamais à un A réussi. En cas de succès le corps répète score et maximum, renvoie percentage, renvoie letter_grade parmi A, B, C, D ou F, et reformule l’identité dans le champ formula. Exemple : score 85 et maximum 100 donnent percentage 85 et lettre B. Exemple : score 45 et maximum 50 donnent percentage 90 et lettre A. Associez le JSON structuré à votre propre bulletin si vous avez besoin de plus ou moins ou d’une courbe ; ce point d’accès ne renvoie que la lettre standard de dix points.

Où une API de lettre d’examen justifie son existence

Les salles de classe et les plateformes de tutorat utilisent un calculateur de note d’examen pour que l’apprenant convertisse le quiz du soir en lettre sans confondre le maximum ni appliquer un poids de syllabus qui n’appartient pas à un seul instrument. Les générateurs d’épreuves et les correcteurs de devoirs ont besoin d’un oracle déterministe qui refuse une note négative et une note supérieure au maximum, au lieu de prendre des valeurs absolues et de marquer des chiffres permutés comme un A. Enseignants et assistants appellent l’API par lot et par copie pour ajouter une colonne vérifiée de pourcentage et de lettre lors de l’export d’une pile de notes brutes, en attrapant les lignes où une note a été saisie au-dessus du total publié. Les greffons de gestion de l’apprentissage qui stockent déjà points obtenus et points possibles peuvent projeter ces deux champs sur score et maximum et obtenir une lettre sans dresser une base de carnet de notes. Comme l’implémentation est du parse pur de niveau A, chaque appel réussi coûte le prix de base publié $0.002 sans jetons de modèle ni réseau sortant. Gardez les requêtes courtes, figez dans les tests le percentage arrondi et letter_grade, et vous obtenez des lettres d’examen reproductibles pour les devoirs, les workers en bordure et les scripts de carnet, sans inventer de courbe, de table de plus ou moins, ni de moyenne de cours pondérée sur la même page.