ForHosting KIT · Entwickler-Tools

Fremden Code verstehen

Diese Funktion nimmt einen eingefügten Codeabschnitt in einer gängigen Programmiersprache und erklärt in verständlichem Deutsch, was er tut, Schritt für Schritt, für alle, die fremden Code lesen müssen, ohne jede Zeile selbst zu entschlüsseln. Auch ohne tiefe Vorkenntnisse in der jeweiligen Sprache bleibt die Erklärung nachvollziehbar.

● Stabilpro Anfrage + pro 1.000 Wörter$0.003

Ausführen — $0.003 + $0.0135/1.000 Wörter API ansehen

Nutzen Sie es über WebAPIE-MailApp baldTelegram bald

Online ausführen

Führen Sie dies mit Ihrem Konto auf unseren Servern aus. Kostenlose Tools laufen in Ihrem Browser; dieses wird zum oben genannten Preis von Ihrem KIT-Guthaben abgebucht.

Was die Erklärung leistet

Die Funktion liest den eingefügten Code und beschreibt in normalem Deutsch, was er bewirkt: welche Eingaben erwartet werden, welche Schritte nacheinander ausgeführt werden und welches Ergebnis am Ende zurückkommt. Bei längeren Abschnitten wird zusätzlich die grobe Struktur zusammengefasst, etwa welche Funktion welchen Teil der Aufgabe übernimmt.

Für wen sich das eignet

Wer eine fremde Codebasis übernimmt, ein altes internes Skript ohne Dokumentation vorfindet oder sich in eine neue Programmiersprache einarbeitet, spart mit dieser Funktion die Zeit, jede Zeile selbst nachzuschlagen. Auch für die Einarbeitung neuer Teammitglieder eignet sich eine automatisch erzeugte Erklärung als erster Überblick, vor dem eigentlichen Code-Review.

Grenzen der Erklärung

Die Erklärung beschreibt, was der Code laut seinem Text tut, kann aber Fehler im Code selbst nicht zuverlässig erkennen, etwa eine falsch verstandene Bibliotheksfunktion oder einen versteckten Randfall. Für eine sicherheitsrelevante Prüfung ersetzt die Erklärung kein eigenes Code-Review durch eine erfahrene Person.

Wo Sie es nutzen

Die Hauptoberfläche ist diese Webseite: Sie fügen den Code ein und erhalten die Erklärung direkt hier. Dasselbe Werkzeug steht auch per API zur Verfügung, für $0.003 pro Anfrage zuzüglich $0.0135 je 1.000 Wörter des eingefügten Codes, etwa für eine automatisierte Dokumentation mehrerer Dateien.

Anwendungsfälle

Einarbeitung in ein fremdes Projekt

Ein neuer Mitarbeiter der Schneider IT-Systeme GmbH & Co. KG lässt sich zentrale Funktionen einer unbekannten Codebasis erklären, bevor er die erste eigene Änderung vornimmt.

Altes Skript ohne Dokumentation

Jonas Weber findet ein Jahre altes, unkommentiertes Abrechnungsskript und lässt es sich erklären, bevor er es an ein neues System anpasst.

Code-Review für weniger erfahrene Teammitglieder

Eine IT-Abteilung lässt komplexe Codeabschnitte automatisch erklären, damit auch weniger erfahrene Teammitglieder beim Code-Review nachvollziehen können, was eine Änderung tatsächlich bewirkt.

Häufige Fragen

Was kostet eine Code-Erklärung?

$0.003 pro Anfrage zuzüglich $0.0135 je 1.000 Wörter des eingefügten Codes.

Welche Programmiersprachen werden verstanden?

Alle gängigen Sprachen wie JavaScript, Python, PHP, Java oder SQL, auch ohne vorherige Angabe der Sprache.

Erkennt die Funktion auch Fehler im Code?

Sie beschreibt vor allem, was der Code tut; offensichtliche Probleme werden oft mit angemerkt, ein vollständiges Code-Review ersetzt das aber nicht.

Gibt es ein Längenlimit?

Für sehr lange Dateien empfiehlt sich eine Aufteilung in mehrere Anfragen, damit die Erklärung übersichtlich bleibt.

Wird mein Code gespeichert?

Nein, der eingefügte Code wird ausschließlich zur Erstellung der Erklärung verarbeitet und danach nicht dauerhaft aufbewahrt.

Ist die Nutzung im Browser kostenlos?

Nein, die Erklärung läuft über ein Sprachmodell und wird pro Anfrage abgerechnet, dafür ohne Abonnement und ohne Konto.

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/dev/code-explain

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/dev/code-explain \
  -H "Authorization: Bearer $KIT_KEY" \
  -H "Content-Type: application/json" \
  -d &#39;{"text":"…"}'

const res = await fetch("https://api.kit.forhosting.com/dev/code-explain", {
  method: "POST",
  headers: {
    "Authorization": `Bearer ${process.env.KIT_KEY}`,
    "Content-Type": "application/json"
  },
  body: JSON.stringify({
    "text": "…"
  })
});
const { task_id } = await res.json();

import os, requests

res = requests.post(
    "https://api.kit.forhosting.com/dev/code-explain",
    headers={"Authorization": f"Bearer {os.environ[&#39;KIT_KEY']}"},
    json={
    "text": "…"
},
)
task_id = res.json()["task_id"]

<?php
$res = file_get_contents("https://api.kit.forhosting.com/dev/code-explain", false, stream_context_create([
  "http" => [
    "method"  => "POST",
    "header"  => "Authorization: Bearer " . getenv("KIT_KEY") . "\r\nContent-Type: application/json",
    "content" => &#39;{"text":"…"}',
  ],
]));
$task = json_decode($res, true);

body := bytes.NewBufferString(`{"text":"…"}`)
req, _ := http.NewRequest("POST", "https://api.kit.forhosting.com/dev/code-explain", body)
req.Header.Set("Authorization", "Bearer "+os.Getenv("KIT_KEY"))
req.Header.Set("Content-Type", "application/json")
res, _ := http.DefaultClient.Do(req)

Beispiel-Anfrage

{
  "text": "…"
}

Beispiel-Antwort

{
  "task_id": "tsk_a1b2c3d4e5f6a1b2c3d4e5f6",
  "type": "dev.code_explain",
  "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.003

pro 1.000 Wörter$0.0135

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.
`422`	`task_failed`	Die Aufgabe ist fehlgeschlagen und wird nicht berechnet.

Vollständige KIT-Dokumentation lesen →