ForHosting KIT · Outils pour développeurs

Vérifier le seuil de réussite d’un examen

Ce vérificateur transforme trois valeurs brutes en un résultat explicite : les points obtenus, le total possible et la note minimale.

● BetaGratuit · dans votre navigateur

Lancer gratuitement Voir l’API

Utilisez-le depuis WebAPIE-mailTelegramApp bientôt

Il indique la réussite, convertit la note et le seuil en pourcentages, puis affiche l’écart en points bruts et en points de pourcentage. Vous pouvez ainsi interpréter correctement une épreuve utilisant n’importe quelle échelle de notation.

Saisissez la note et le seuil sur la même échelle

Utilisez la note brute obtenue, le maximum de l’épreuve et la note minimale, tous exprimés sur la même échelle. Pour une épreuve sur 80 où 58 points ont été obtenus et 48 sont requis, saisissez 58, 80 et 48. Ne saisissez pas 60 comme seuil sous prétexte que 48 sur 80 équivaut à 60 pour cent : l’outil effectue cette conversion. Les décimales sont admises en cas de crédit partiel. La note et le seuil doivent être compris entre zéro et le total, lequel doit être strictement positif. Cette règle évite de comparer par erreur un pourcentage à des points. L’outil n’invente aucune politique de notation et applique uniquement le seuil que vous fournissez.

Lisez le résultat, les pourcentages et l’écart

Le champ passed est vrai lorsque la note brute atteint ou dépasse le seuil. Une égalité vaut réussite, puisque le seuil est la plus petite note acceptable. percentage représente la part des points obtenus et passing_percentage convertit le seuil sur la même échelle. margin_points soustrait le seuil à la note : une valeur positive indique un excédent, zéro une égalité exacte et une valeur négative le manque. margin_percentage_points exprime ce même écart par rapport au total. Passer d’un seuil de 60 pour cent à un résultat de 65 pour cent correspond bien à cinq points de pourcentage. Les résultats sont arrondis à six décimales au maximum afin de préserver la précision et la stabilité.

Employez le calcul de manière cohérente

Cet outil convient lorsque la règle officielle est connue, mais que l’échelle brute complique la lecture. Un enseignant peut contrôler une note avant publication, un étudiant mesurer sa distance au seuil et un service administratif appliquer une règle identique à plusieurs dossiers. L’outil ne choisit pas le seuil, ne crée pas de courbe, ne supprime pas de questions et ne pondère pas les catégories. Réglez ces choix en amont. Pour un cours combinant plusieurs coefficients, calculez d’abord la note brute officielle et son total, ou suivez le logiciel approuvé. L’écart reste une explication arithmétique, non une autorisation de contourner le règlement. Chaque requête API automatisée coûte $0.002.

Cas d’usage

Confirmer un résultat individuel

Comparez les points obtenus au seuil publié et communiquez le pourcentage ainsi que l’écart exact.

Expliquer un échec de peu

Montrez combien de points bruts et de points de pourcentage manquent sans conversion manuelle.

Automatiser les contrôles

Appliquez uniformément un seuil connu et conservez des données claires pour vos rapports et audits.

Questions fréquentes

Une note exactement égale au seuil est-elle suffisante ?

Oui. Le seuil est le minimum requis : passed vaut vrai et les deux écarts valent zéro.

Faut-il saisir le seuil en points ou en pourcentage ?

Saisissez des points bruts sur la même échelle que la note et le total. L’outil calcule le pourcentage.

Les valeurs décimales sont-elles acceptées ?

Oui. Les nombres décimaux finis conviennent aux épreuves accordant des fractions de point.

Que signifie un écart négatif ?

La note est sous le seuil. La valeur absolue indique le manque en points bruts ou en points de pourcentage.

L’outil applique-t-il une courbe ou des coefficients ?

Non. Il compare uniquement la note et le seuil fournis. Appliquez auparavant toute pondération.

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

Chaque requête API coûte $0.002. La version web peut exécuter localement le même calcul déterministe.

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/exam-pass-threshold

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/exam-pass-threshold \
  -H "Authorization: Bearer $KIT_KEY" \
  -H "Content-Type: application/json" \
  -d '{"score":72,"total":100,"passing_mark":70}'

const res = await fetch("https://api.kit.forhosting.com/edu/exam-pass-threshold", {
  method: "POST",
  headers: {
    "Authorization": `Bearer ${process.env.KIT_KEY}`,
    "Content-Type": "application/json"
  },
  body: JSON.stringify({
    "score": 72,
    "total": 100,
    "passing_mark": 70
  })
});
const { task_id } = await res.json();

import os, requests

res = requests.post(
    "https://api.kit.forhosting.com/edu/exam-pass-threshold",
    headers={"Authorization": f"Bearer {os.environ['KIT_KEY']}"},
    json={
    "score": 72,
    "total": 100,
    "passing_mark": 70
},
)
task_id = res.json()["task_id"]

<?php
$res = file_get_contents("https://api.kit.forhosting.com/edu/exam-pass-threshold", false, stream_context_create([
  "http" => [
    "method"  => "POST",
    "header"  => "Authorization: Bearer " . getenv("KIT_KEY") . "\r\nContent-Type: application/json",
    "content" => '{"score":72,"total":100,"passing_mark":70}',
  ],
]));
$task = json_decode($res, true);

body := bytes.NewBufferString(`{"score":72,"total":100,"passing_mark":70}`)
req, _ := http.NewRequest("POST", "https://api.kit.forhosting.com/edu/exam-pass-threshold", 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

{
  "score": 72,
  "total": 100,
  "passing_mark": 70
}

Exemple de réponse

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

Consulter la documentation complète du KIT →