Fehlercodes
/v1/siteverify antwortet bei Misserfolg mit success: false und
error-codes. Die Namen sind, wo möglich, reCAPTCHA-kompatibel — bestehende
Integrationen fühlen sich vertraut an.
| Code | Bedeutung | Empfohlene Reaktion |
|---|---|---|
missing-input-secret |
Kein Secret übergeben | Integration korrigieren |
invalid-input-secret |
Secret unbekannt (rotiert? falsches Environment?) | Schlüssel im Dashboard prüfen |
missing-input-response |
Kein Token übergeben (JS deaktiviert, Widget nicht geladen) | Siehe Umgang mit fehlendem Token |
invalid-input-response |
Token ungültig: manipuliert, falsche Signatur oder Proof-of-Work falsch | Submission ablehnen |
timeout-or-duplicate |
Token abgelaufen oder bereits verwendet (Replay) | Submission ablehnen; Formular erneut absenden lassen |
hostname-mismatch |
Token wurde für einen anderen Hostnamen gelöst | Hostname-Liste im Dashboard prüfen |
quota-exceeded |
Kontingent erschöpft / Zahlung ausstehend — kein Bot-Verdacht | Siehe Verhalten bei quota-exceeded |
bad-request |
Anfrage nicht lesbar (Encoding/Content-Type) | Integration korrigieren |