Codici di errore comuni
Riferimento rapido per tutti i codici di errore restituiti dall'API di SilentShield.
| Status | Error | Description | Solution |
|---|---|---|---|
400 | validation_error | Corpo della richiesta non valido o campi obbligatori mancanti. | Verifichi che il formato della richiesta corrisponda alla documentazione dell'API. |
401 | missing_api_key | La API Key è assente dalla richiesta. | Aggiunga l'header X-Api-Key alla Sua richiesta. |
403 | ip_not_whitelisted | L'IP del client non è nella whitelist della politica di sicurezza. | Aggiunga l'IP alla whitelist in Dashboard → Politica di sicurezza. |
403 | ip_blacklisted | L'IP del client è nella blacklist della politica di sicurezza. | Rimuova l'IP dalla blacklist in Dashboard → Politica di sicurezza. |
403 | domain_mismatch | Il dominio Origin/Referer della richiesta non corrisponde al dominio della API Key. | Aggiorni il dominio in Dashboard → API Keys → Modifica. |
403 | referer_not_allowed | Il dominio referer non è nell'elenco dei referer consentiti. | Aggiunga il dominio ai Referer consentiti nella Politica di sicurezza. |
429 | quota_exceeded | La quota mensile di richieste è stata superata. | Aggiorni il Suo piano o attenda il ripristino della quota. |
429 | ip_rate_limited | Il limite di frequenza per IP è stato raggiunto. | Attenda 60 secondi. L'header Retry-After indica quando riprovare. |
200 | X-Domain-Test-Limit-Exceeded | Dominio non verificato: più di 10 richieste al giorno in modalità test. La richiesta NON viene rifiutata: lo segnala solo l'intestazione X-Domain-Test-Limit-Exceeded. | Verifichi il Suo dominio per sbloccare la quota completa. |
403 | suspicious | Un visitatore reale viene respinto da /v1/verify con il verdetto suspicious e motivi come NO_TYPING_PAUSES. Il widget non ha ricevuto l’invio, ad esempio perché il modulo viene inviato con il clic su un pulsante e AJAX senza evento submit. | Inserisca il campo behavior_nonce nel corpo della richiesta (serializzi l’intero modulo, anche i campi nascosti). Le richieste effettuate con XMLHttpRequest, compreso jQuery.ajax, vengono quindi segnalate dal widget a partire da SilentShield 2.6. Le richieste effettuate con fetch() non vengono ancora segnalate: usi un normale invio del modulo o contatti il supporto. |