ForHosting KIT · Entwickler-Tools

Gesamtnote aus Kategorien

Die meisten Lehrpläne mitteln nicht jedes Quiz und jede Hausaufgabe in einem einzigen laufenden Haufen.

● BetaKostenlos · im Browser

Im Browser ausführen – kostenlos API ansehen

Nutzen Sie es über WebAPIE-MailTelegramApp bald

Sie teilen das Semester in benannte Kategorien — Hausaufgaben, Quizzes, Labore, eine Zwischenprüfung, ein Abschlussprojekt — jede mit eigenem Schnitt und einem veröffentlichten Gewicht. Lernende, Lehrkräfte und Beratende, die diese Kategorieschnitte bereits haben, brauchen trotzdem einen Gesamtprozentsatz des Kurses und einen Buchstaben für Zeugnis oder eine Vorschau der Leistungsübersicht. Dieser Rechner für die Gesamtnote aus Kategorien nimmt jeden Kategorieschnitt mit seinem Lehrplangewicht, bildet das gewichtete Mittel und ordnet den gerundeten Prozentwert einer dokumentierten US-Zehn-Punkte-Buchstabenskala mit Plus- und Minus-Bändern zu. Dasselbe reine Modul speist das kostenlose Browser-Widget und die API, sodass ein Notenbuch-Skript und eine Prüfung im Familienportal stets übereinstimmen. Ohne Kurve, ohne Prognose der Restarbeit und ohne Netzwerkanruf: nur die Gesamtnote des Kurses, die die Kategorientabelle des Lehrplans impliziert.

So verwenden Sie das Werkzeug

Geben Sie Ihre Werte in das Formular oben ein. Das Werkzeug prüft sie vor der Berechnung und zeigt das Ergebnis auf derselben Seite.

Eingaben prüfen

Beachten Sie die Beschriftungen und Einheiten der Felder. Fehlt etwas oder liegt ein Wert außerhalb des erlaubten Bereichs, zeigt die Seite das zu korrigierende Feld.

Erneut berechnen oder automatisieren

Nutzen Sie das Web-Werkzeug für einzelne Prüfungen und die API, wenn Sie dieselbe Funktion automatisieren möchten.

Anwendungsfälle

Sofort ein Ergebnis erhalten

Geben Sie einen Satz Werte ein und sehen Sie das Ergebnis ohne Tabellenkalkulation oder Skript.

Szenarien vergleichen

Ändern Sie jeweils einen Wert und berechnen Sie erneut, um den Einfluss auf das Ergebnis zu sehen.

Wiederholte Aufgaben automatisieren

Nutzen Sie die API, wenn dieselbe Berechnung in Ihrem Produkt oder Ablauf laufen soll.

Häufige Fragen

Wie verwende ich diese Funktion?

Füllen Sie die Felder oben aus und starten Sie sie auf dieser Seite. Das Formular markiert Angaben, die korrigiert werden müssen.

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/overall-from-categories

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/overall-from-categories \
  -H "Authorization: Bearer $KIT_KEY" \
  -H "Content-Type: application/json" \
  -d '{"categories":[{"name":"Homework","average":92,"weight":20},{"name":"Quizzes","average":88,"weight":15},{"name":"Midterm","average":79,"weight":25},{"name":"Final","average":85,"weight":40}]}'

const res = await fetch("https://api.kit.forhosting.com/edu/overall-from-categories", {
  method: "POST",
  headers: {
    "Authorization": `Bearer ${process.env.KIT_KEY}`,
    "Content-Type": "application/json"
  },
  body: JSON.stringify({
    "categories": [
      {
        "name": "Homework",
        "average": 92,
        "weight": 20
      },
      {
        "name": "Quizzes",
        "average": 88,
        "weight": 15
      },
      {
        "name": "Midterm",
        "average": 79,
        "weight": 25
      },
      {
        "name": "Final",
        "average": 85,
        "weight": 40
      }
    ]
  })
});
const { task_id } = await res.json();

import os, requests

res = requests.post(
    "https://api.kit.forhosting.com/edu/overall-from-categories",
    headers={"Authorization": f"Bearer {os.environ['KIT_KEY']}"},
    json={
    "categories": [
        {
            "name": "Homework",
            "average": 92,
            "weight": 20
        },
        {
            "name": "Quizzes",
            "average": 88,
            "weight": 15
        },
        {
            "name": "Midterm",
            "average": 79,
            "weight": 25
        },
        {
            "name": "Final",
            "average": 85,
            "weight": 40
        }
    ]
},
)
task_id = res.json()["task_id"]

<?php
$res = file_get_contents("https://api.kit.forhosting.com/edu/overall-from-categories", false, stream_context_create([
  "http" => [
    "method"  => "POST",
    "header"  => "Authorization: Bearer " . getenv("KIT_KEY") . "\r\nContent-Type: application/json",
    "content" => '{"categories":[{"name":"Homework","average":92,"weight":20},{"name":"Quizzes","average":88,"weight":15},{"name":"Midterm","average":79,"weight":25},{"name":"Final","average":85,"weight":40}]}',
  ],
]));
$task = json_decode($res, true);

body := bytes.NewBufferString(`{"categories":[{"name":"Homework","average":92,"weight":20},{"name":"Quizzes","average":88,"weight":15},{"name":"Midterm","average":79,"weight":25},{"name":"Final","average":85,"weight":40}]}`)
req, _ := http.NewRequest("POST", "https://api.kit.forhosting.com/edu/overall-from-categories", body)
req.Header.Set("Authorization", "Bearer "+os.Getenv("KIT_KEY"))
req.Header.Set("Content-Type", "application/json")
res, _ := http.DefaultClient.Do(req)

Beispiel-Anfrage

{
  "categories": [
    {
      "name": "Homework",
      "average": 92,
      "weight": 20
    },
    {
      "name": "Quizzes",
      "average": 88,
      "weight": 15
    },
    {
      "name": "Midterm",
      "average": 79,
      "weight": 25
    },
    {
      "name": "Final",
      "average": 85,
      "weight": 40
    }
  ]
}

Beispiel-Antwort

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

Limits

max_items 40

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 →