ForHosting KIT · Entwickler-Tools

Prüfung bestanden? Punktzahl, Prozent und Abstand

Der Rechner macht aus drei Rohwerten ein klares Ergebnis: erreichte Punkte, maximal mögliche Punkte und Mindestpunktzahl. Er zeigt, ob Sie bestanden haben, rechnet Ergebnis und Grenze in Prozent um und nennt den Abstand in Rohpunkten sowie Prozentpunkten. Dadurch lassen sich auch Prüfungen mit ungewohnten Punkteskalen zuverlässig beurteilen.

● BetaKostenlos · im Browser

Im Browser ausführen – kostenlos API ansehen

Nutzen Sie es über WebAPIE-MailTelegramApp bald

Geben Sie Ergebnis und Grenze auf derselben Skala ein

Verwenden Sie die erreichten Rohpunkte, die maximal mögliche Punktzahl und die Mindestpunktzahl auf derselben Skala. Ist eine Prüfung 80 Punkte wert, wurden 58 erreicht und sind 48 nötig, geben Sie 58, 80 und 48 ein. Tragen Sie nicht 60 als Grenze ein, nur weil 48 von 80 gleich 60 Prozent sind; diese Umrechnung übernimmt das Werkzeug. Dezimalwerte sind bei Teilpunkten zulässig. Ergebnis und Grenze müssen zwischen null und der Gesamtpunktzahl liegen, die größer als null sein muss. So vermeiden Sie den häufigen Fehler, Prozentwerte direkt mit Punkten zu vergleichen. Weitere Bewertungsregeln werden nicht angenommen; maßgeblich ist ausschließlich die von Ihnen angegebene Grenze.

Verstehen Sie Ergebnis, Prozentwerte und Abstand

passed ist wahr, wenn die Rohpunktzahl mindestens der Bestehensgrenze entspricht. Gleichheit gilt als bestanden, weil die Grenze den kleinsten akzeptierten Wert darstellt. percentage zeigt den Anteil der erreichten Gesamtpunkte, passing_percentage die Grenze auf derselben Prozentskala. margin_points ist Ergebnis minus Grenze: positiv bedeutet darüber, null genau darauf und negativ darunter. margin_percentage_points setzt dieselbe Differenz ins Verhältnis zur Gesamtpunktzahl. Von einer Grenze bei 60 Prozent zu einem Ergebnis von 65 Prozent sind es fünf Prozentpunkte. Die Ausgabe wird auf höchstens sechs Dezimalstellen gerundet und bleibt dadurch präzise sowie stabil.

Nutzen Sie die Berechnung einheitlich und verantwortungsvoll

Das Werkzeug eignet sich, wenn die offizielle Regel feststeht, die Rohskala aber schwer zu lesen ist. Lehrkräfte können Ergebnisse vor der Veröffentlichung prüfen, Lernende den Abstand zur Anforderung verstehen und Verwaltungen dieselbe Grenze auf viele Datensätze anwenden. Das Werkzeug bestimmt keine Mindestnote, erstellt keine Kurve, streicht keine Aufgaben und gewichtet keine Kategorien. Solche Regeln müssen vorher geklärt werden. Bei unterschiedlich gewichteten Leistungen berechnen Sie zuerst das offizielle Gesamtergebnis und die passende Gesamtpunktzahl oder verwenden das genehmigte Notensystem. Der Abstand ist eine mathematische Erläuterung und ersetzt keine Prüfungsordnung. Eine automatisierte API-Anfrage kostet $0.002.

Anwendungsfälle

Ein Prüfungsergebnis bestätigen

Vergleichen Sie Rohpunkte mit der veröffentlichten Grenze und nennen Sie Prozentwert sowie genauen Abstand.

Knappes Nichtbestehen erklären

Zeigen Sie ohne manuelle Umrechnung, wie viele Roh- und Prozentpunkte zur Grenze fehlen.

Grenzprüfungen automatisieren

Wenden Sie eine bekannte Grenze einheitlich an und behalten Sie klare Werte für Berichte und Prüfungen.

Häufige Fragen

Gilt genau die Mindestpunktzahl als bestanden?

Ja. Die Grenze ist das Minimum; passed ist wahr und beide Abstände sind null.

Gebe ich die Grenze als Punkte oder Prozent ein?

Geben Sie Rohpunkte auf derselben Skala wie Ergebnis und Gesamtwert ein. Das Werkzeug berechnet den Prozentsatz.

Sind Dezimalwerte möglich?

Ja. Endliche Dezimalzahlen werden für Prüfungen mit Teilpunkten akzeptiert.

Was bedeutet ein negativer Abstand?

Das Ergebnis liegt unter der Grenze. Der Betrag zeigt die fehlenden Roh- oder Prozentpunkte.

Werden Kurven oder Gewichtungen angewandt?

Nein. Verglichen werden nur Ergebnis und Grenze. Wenden Sie solche Regeln vorher an.

Was kostet eine API-Anfrage?

Jede API-Anfrage kostet $0.002. Die Browserversion führt dieselbe deterministische Rechnung lokal aus.

Für Entwickler — API-Zugang

Alles auf dieser Seite ist auch per API verfügbar. Dieser Abschnitt richtet sich an Teams, die es in ihre eigenen Systeme einbinden möchten; alle anderen nutzen einfach das Tool oben.

Endpunkt

POSThttps://api.kit.forhosting.com/edu/exam-pass-threshold

Authentifizierung per Bearer-Token. Ein einziger POST stellt die Aufgabe in die Warteschlange; das Ergebnis erhalten Sie per Webhook oder über einen signierten Link.

Aufruf aus Ihrem 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)

Beispiel-Anfrage

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

Beispiel-Antwort

{
  "task_id": "tsk_a1b2c3d4e5f6a1b2c3d4e5f6",
  "type": "edu.exam_pass_threshold",
  "status": "queued",
  "_links": {
    "result": "/tasks/tsk_…/result"
  }
}

Die API arbeitet asynchron: Sie erhalten sofort eine task_id. Polling ist mit 1 Anfrage pro Sekunde erlaubt.

Preis

pro Anfrage$0.002

Der Preis steht auf der Seite – keine Tokens, keine Credits. Fehlgeschlagene Aufgaben werden nicht berechnet.

Fehler

HTTP	Code	Bedeutung
`401`	`unauthorized`	Der API-Schlüssel fehlt oder ist ungültig – prüfen Sie den Authorization-Header (Bearer).
`402`	`insufficient_balance`	Ihr Guthaben reicht für diese Aufgabe nicht aus – Aufladungen verfallen nicht.
`404`	`unknown_type`	Unbekannter Aufgabentyp – prüfen Sie das Feld „type“ gegen den Katalog.
`429`	`rate_limited`	Zu viele Anfragen – warten Sie kurz; Polling ist mit 1 Anfrage pro Sekunde erlaubt.

Vollständige KIT-Dokumentation lesen →