REST-API / KI-Scan (Beta)

KI-Scan (Beta)

Beim KI-Scan prüft ein Mensch. Sie fragen ihn für eine verifizierte Domain an, ein Prüfer von Redcheck untersucht die Seite mit Unterstützung durch KI und schreibt den Bericht. Ergebnis ist ein PDF, das am Lauf hängt wie bei jedem anderen Scan.

Den KI-Scan gibt es nur im Plan Agentur. Er ist eine Beta: Ablauf und Antwort können sich noch ändern, und wir sagen es vorher an.

Anfrage

POSThttps://api.red-check.de/v1/scans/ki

Anfrage

curl -X POST https://api.red-check.de/v1/scans/ki \
  -H "Authorization: Bearer rc_live_••••••••" \
  -H "Content-Type: application/json" \
  -d '{
  "domain_id": "3f9a1c20-5e4b-4d8a-9a11-0c21e7b4c21e",
  "hints": ""
}'

Anfragen dürfen Schlüssel mit den Rechten start_scans und full. Einen KI-Scan über den MCP-Server gibt es nicht.

Felder

FeldTypBeschreibung

domain_id

uuidPflicht

–

hints

string

Was Redcheck wissen sollte: Schwerpunkte, bekannte Eigenheiten, Zugänge, die bewusst fehlen. Optional.Vorgabe ""

In hints steht, was der Prüfer wissen sollte: wo Sie genauer hinsehen lassen wollen, welche Bereiche bewusst fehlen, was an der Seite ungewöhnlich ist. Das Feld ist optional und fasst bis zu 2000 Zeichen.

Ablauf

Die Antwort kommt mit 202 und dem angelegten Lauf. Er trägt ki: true und steht im Status awaiting_review, „wartet auf Prüfer“. Einen Fortschritt gibt es in dieser Zeit nicht, weil kein Worker läuft.

Antwort

{
  "id": "3f9a1c20-5e4b-4d8a-9a11-0c21e7b4c21e",
  "domain": "",
  "status": "queued",
  "ki": false,
  "ki_hints": "",
  "created_at": "2026-09-03T09:14:22Z"
}

Danach endet der Lauf auf eine von zwei Arten:

Status	Bedeutung
`done`	Der Bericht ist fertig. Das PDF holen Sie wie gewohnt über die Artefakte.
`canceled`	Redcheck hat die Anfrage abgelehnt. Den Grund nennt `cancel_reason`.

Eine Ablehnung geht mit ihrer Begründung immer per E-Mail an die Person, die angefragt hat. Ist der Bericht fertig, schreiben wir allen in Ihrer Organisation, die unter „Benachrichtigungen“ den Schalter „Scan abgeschlossen“ eingeschaltet haben. Weil ein Mensch prüft, bringt enges Abfragen nichts: alle paar Minuten reicht.

Abrechnung

Der KI-Scan ist ein eigenes Paket mit eigenem Preis, ki in details.packages und in der Nutzung. Berechnet wird er erst, wenn der Bericht fertig ist, zum Preis, der dann gilt. Eine abgelehnte Anfrage kostet nichts.

Ist für das Paket ki noch kein Preis vereinbart, weist die API die Anfrage mit 402 price_not_set ab. Den Preis tragen wir ein; sprechen Sie uns dafür an.

Fehlercodes

202

Angefragt, wartet auf den Prüfer.

400

Eingabe ungültig (`validation_failed`).

402

`plan_upgrade_required` außerhalb des Plans Agentur (`details.feature = "ki_scan"`), `price_not_set` ohne hinterlegten KI-Preis (`details.packages = ["ki"]`), `payment_method_required` ohne Zahlungsmittel.

403

Domain nicht verifiziert (`domain_not_verified`), Organisation gedrosselt (`organization_throttled`) oder gesperrt (`organization_blocked`), die Rolle reicht nicht (`insufficient_role`), oder der API-Schlüssel darf keine Scans starten (`api_key_scope_insufficient`).

404

Nicht gefunden (`not_found`).

429

Zu viele Anfragen (`rate_limited`).

Außerhalb des Plans Agentur kommt 402 plan_upgrade_required mit details.feature = "ki_scan". Eine Domain ohne Eigentumsnachweis ergibt 403 domain_not_verified; wie Sie den Nachweis führen, steht unter Domain verifizieren. Alle Codes mit Status stehen unter Konventionen.