Einstieg / Domain verifizieren

Domain verifizieren

Warum

Aktive Prüfungen gegen fremde Systeme sind ohne Berechtigung strafbar. Redcheck schaltet sie deshalb erst frei, wenn das Eigentum an der Domain nachgewiesen ist. Passive Läufe brauchen keinen Nachweis, auch nicht für Datenschutz und Barrierefreiheit.

Verifiziert wird immer der Apex, bestimmt über die Public-Suffix-Liste. *.apex ist damit mitgescannt und zählt nicht als weitere abgerechnete Domain.

Domain anlegen

POSThttps://api.red-check.de/v1/domains

Alles Weitere zu Domains, auch Ändern und Entfernen, steht unter Domains.

FeldTypBeschreibung

name

stringPflicht

Ohne Schema, ohne Pfad. `https://` wird toleriert und entfernt.

context

enum

Kontextprofil der Domain. Etiketten: Shop · Broschüre · Anwendung · Intern. Steuert die Eskalation der Schweregrade im Katalog.shop · brochure · saas · internal

client_id

string | null

Kunde aus `/v1/clients`. Hat Vorrang vor `client_name`: Ist beides gesetzt, gilt die Kennung, und der Name wird aus ihr abgeleitet.

client_name

string

Freitext-Zuordnung für Organisationen ohne Kundenverwaltung. Leer = keine Zuordnung.

Anfrage

curl -X POST https://api.red-check.de/v1/domains \
  -H "Authorization: Bearer rc_live_••••••••" \
  -H "Content-Type: application/json" \
  -d '{
  "name": "example.de",
  "context": "shop"
}'

201

Angelegt.

400

Kein gültiger Domainname (`invalid_domain`).

402

Kontingent erschöpft (`quota_exceeded`).

409

Zustand passt nicht (`conflict`, `already_exists`).

Nachweis abrufen

POSThttps://api.red-check.de/v1/domains/{id}/verification

Wählen Sie eine der drei Methoden. Die Antwort enthält Token und fertige Anleitung. Anfordern und Prüfen gehen mit Schlüsseln der Rechte start_scans und full.

FeldTypBeschreibung

method

enumPflicht

DNS-TXT · Datei unter `/.well-known/` · Meta-Tag.dns_txt · file · meta

Methode	Was zu tun ist
`dns_txt`	TXT-Eintrag auf `_redcheck.<domain>` mit dem Wert `redcheck-verify=<token>`
`file`	Datei unter `/.well-known/redcheck-<token>` mit dem Token als Inhalt, ohne Dateiendung
`meta`	`<meta name="redcheck-verify" content="<token>">` im `<head>` der Startseite

Das Feld instructions liefert die Werte bereits fertig aufbereitet:

FeldTypBeschreibung

host

string

–

record_type

string

–

value

string

–

path

string

–

file_content

string

–

meta_tag

string

–

Prüfung anstoßen

POSThttps://api.red-check.de/v1/domains/{id}/verification/check

Die Plattform prüft ausstehende Nachweise alle zehn Minuten selbst. Mit diesem Aufruf prüfen Sie sofort.

Anfrage

curl -X POST https://api.red-check.de/v1/domains/{id}/verification/check \
  -H "Authorization: Bearer rc_live_••••••••" \
  -H "Content-Type: application/json" \
  -d '{
  "method": "dns_txt"
}'

200

Ergebnis der Prüfung.

400

Eingabe ungültig (`validation_failed`).

429

Zu viele Anfragen (`rate_limited`).

IP-Pinning

Mit der Verifikation fixiert Redcheck die aufgelösten IP-Adressen. Jede aktive Anfrage wird danach gegen diese Adressen geprüft und nicht allein gegen den Hostnamen. Zeigt der DNS-Eintrag später auf ein fremdes System, läuft Redcheck dort also nicht.

GEThttps://api.red-check.de/v1/domains/{id}/ips

Wandert der Adresssatz, hebt die Nachprüfung die Bindung auf. Eine erneute Verifikation stellt sie wieder her. Eine Agentur ohne Eigentumsnachweis bestätigt den neuen Satz über POST /v1/domains/{id}/pin. Das verlangt die Rolle Admin und geht deshalb nur in der Web-App.