Häufige Fehlercodes
Schnellreferenz für alle Fehlercodes der SilentShield-API.
| Status | Error | Description | Solution |
|---|---|---|---|
400 | validation_error | Ungültiger Request-Body oder fehlende Pflichtfelder. | Prüfen Sie, ob das Request-Format der API-Dokumentation entspricht. |
401 | missing_api_key | API-Key fehlt in der Anfrage. | Fügen Sie den X-Api-Key Header zu Ihrer Anfrage hinzu. |
403 | ip_not_whitelisted | Client-IP ist nicht in der Whitelist der Sicherheitsrichtlinie. | Fügen Sie die IP zur Whitelist unter Dashboard → Sicherheitsrichtlinie hinzu. |
403 | ip_blacklisted | Client-IP ist in der Blacklist der Sicherheitsrichtlinie. | Entfernen Sie die IP aus der Blacklist unter Dashboard → Sicherheitsrichtlinie. |
403 | domain_mismatch | Die Origin-/Referer-Domain der Anfrage stimmt nicht mit der API-Key-Domain überein. | Aktualisieren Sie die Domain unter Dashboard → API-Keys → Bearbeiten. |
403 | referer_not_allowed | Die Referer-Domain ist nicht in der Liste erlaubter Referer. | Fügen Sie die Domain zu Erlaubte Referer in der Sicherheitsrichtlinie hinzu. |
429 | quota_exceeded | Das monatliche Anfragekontingent wurde überschritten. | Upgraden Sie Ihren Plan oder warten Sie auf den Kontingent-Reset. |
429 | ip_rate_limited | Das IP-Rate-Limit wurde erreicht. | Warten Sie 60 Sekunden. Der Retry-After Header zeigt an, wann erneut versucht werden kann. |
200 | X-Domain-Test-Limit-Exceeded | Unverifizierte Domain: mehr als 10 Anfragen am Tag im Testmodus. Die Anfrage wird NICHT abgewiesen — nur die Kopfzeile X-Domain-Test-Limit-Exceeded signalisiert es. | Verifizieren Sie Ihre Domain, um Ihr volles Kontingent freizuschalten. |
403 | suspicious | Ein echter Besucher wird von /v1/verify mit dem Urteil suspicious und Gründen wie NO_TYPING_PAUSES abgewiesen. Das Widget hat die Absendung nicht erhalten, etwa weil das Formular per Knopfdruck und AJAX ohne Submit-Ereignis abgeschickt wird. | Nehmen Sie das Feld behavior_nonce in den Anfragekörper auf (das ganze Formular serialisieren, auch versteckte Felder). Anfragen mit XMLHttpRequest, auch jQuery.ajax, meldet das Widget dann seit SilentShield 2.6. Anfragen mit fetch() werden noch nicht gemeldet: Senden Sie das Formular regulär ab oder wenden Sie sich an den Support. |