Antworten und Fehlercodes der API

Was die Statuscodes von /v1/verify bedeuten und wie dein Backend darauf reagieren sollte.

Statuscodes

Code	Bedeutung	Was tun
200 mit `ok: true`	Mensch, Formular annehmen.	Normal verarbeiten.
400	`missing_token`, `missing_params`, `invalid_token` oder `replay_or_expired`: Token fehlt, ist ungültig, abgelaufen oder schon benutzt.	Einsendung ablehnen.
401	`invalid_secret`: Secret passt nicht zum Site-Key.	Aktuelles Secret eintragen oder rotieren.
402	`payment_required` oder `plan_limit`: Abo nicht aktiv oder Kontingent erschöpft.	Abrechnung prüfen.
403	Als Bot eingestuft, oder Domain bzw. Action nicht freigegeben.	Ablehnen. Bei Freigabe-Problemen Domain oder Action im Dashboard eintragen.
429	`rate_limited`: zu viele Versuche.	Später erneut versuchen.

Die vollständige Referenz mit allen Feldern steht in der API-Dokumentation.

Noch Fragen? Wir helfen gern weiter.

Stand: 5. Oktober 2026