Verhalten bei quota-exceeded
Wenn Ihr Kontingent erschöpft ist (Free-Tier) oder eine Zahlung nach Ablauf
der 14-tägigen Kulanzfrist aussteht, liefert /v1/siteverify einen
eindeutigen Fehlercode:
{ "success": false, "error-codes": ["quota-exceeded"] }
quota-exceeded bedeutet nicht „Bot“. Es bedeutet: simplecaptcha konnte
diese Anfrage nicht mehr für Sie prüfen. Behandeln Sie diesen Fall deshalb
anders als einen echten Captcha-Fehlschlag — blockieren Sie keine echten
Kundinnen und Kunden, weil Ihr Kontingent aufgebraucht ist:
const result = await captcha.verify(token)
if (result.success) {
await handleSubmission()
} else if (result.errorCodes?.includes('quota-exceeded')) {
// Schutz degradiert, aber Formular bleibt funktionsfähig:
// Submission annehmen und ggf. zur manuellen Prüfung markieren.
await handleSubmission({ unverified: true })
} else {
// Echter Captcha-Fehlschlag → ablehnen.
reject()
}
So bleibt Ihr Formular auch im schlimmsten Fall benutzbar — es verliert nur vorübergehend den Spam-Schutz. Sie werden lange vor der Abschaltung mehrfach per E-Mail und im Dashboard gewarnt (80 %, 100 %, Kulanzfrist, 48-Stunden-Hinweis).