REFERENCE · VERIFY API

Response-Codes

Alle möglichen Ergebnis-Werte des Liorith Verify-Systems - Proof-Verifikation, Registry-Prüfung und Site-Status.

GET/api/proof?site=…&host=…&ts=…&nonce=…&sig=…

GET/api/check?domain=…

Alle Endpunkte geben { result: string, ... } als application/json zurück.

Proof-Verifikation

/proof · /api/proof

verified_signed

Signierte Anfrage verifiziert

HMAC-SHA256 gültig, Nonce unverbraucht, Host in allowed_domains, Site aktiv. Stärkste Bestätigung.

valid_deprecated

Gültig - wird eingestellt

Wie verified_signed, aber Status = deprecated. Proof gültig, aber mit Hinweis auf Nachfolger.

expired

Proof abgelaufen

Timestamp liegt mehr als 120 Sekunden in der Vergangenheit. Proof-Links sind bewusst kurzlebig.

clock_skew

Timestamp-Fehler

Timestamp liegt mehr als 30 s in der Zukunft. Serverseitig muss NTP synchron sein.

host_mismatch

Domain passt nicht

Signatur korrekt, aber Host steht nicht in allowed_domains der angegebenen Site.

replay

Bereits verwendet

Nonce bereits eingelöst. Jeder Proof-Link ist Einmalverwendung - schützt vor Replay-Angriffen.

malformed

Ungültige Anfrage

Pflichtparameter fehlen oder haben ein ungültiges Format. Kein Lookup wird durchgeführt.

invalid_signature

Signatur ungültig

HMAC-Vergleich fehlgeschlagen. Manipulierter Link, unbekanntes System oder beschädigte URL.

site_inactive

Site deaktiviert

Site in der Registry, aber Status = inactive. Proofs werden vorübergehend nicht angenommen.

site_archived

Archivierter Registry-Eintrag

Site war Teil des Liorith-Netzwerks und wurde archiviert. Keine Proofs mehr angenommen.

site_suspended

Site gesperrt

Site aus der Registry gesperrt (Policy-Verstoß). Alle Proofs dieser Site werden abgelehnt.

unknown_site

Unbekannte Site-ID

Die site_id im Proof existiert nicht in der Liorith Registry.

blacklisted

Bekannte Bedrohung

Host auf der Liorith Blacklist. Wird vor allen anderen Prüfungen abgefangen.

Registry-Prüfung

/check · /api/check

verified_registry

In der Registry

Domain in allowed_domains gefunden. status enthält active / deprecated / inactive / former / suspended.

unknown

Nicht in der Registry

Domain ist nicht in der Liorith Registry eingetragen.

blacklisted

Bekannte Bedrohung

Domain auf der Blacklist. Registry-Lookup wird übersprungen.

Site-Status

sites.json · status

active

Normale Verifikation - alle Proofs werden angenommen

deprecated

Eingestellt - Proof gültig (valid_deprecated), aber mit Warnung

inactive

Vorübergehend deaktiviert - kein Proof angenommen (site_inactive)

former

Archiviert - kein Proof angenommen (site_archived)

suspended

Gesperrt - kein Proof angenommen (site_suspended)