What do errors mean when sending webhooks ?
Di seguito sono riportati gli errori più comuni nell'invio dei webhook e le loro possibili cause. La maggior parte degli errori è legata al server ricevente. In tal caso, ti consigliamo di contattare il team di supporto del servizio che riceve i webhook.
- Errori 3xx (Reindirizzamento) – il server indica che la richiesta deve essere inviata a un indirizzo diverso.
Possibili cause:
- il dominio o il percorso è cambiato
- il server reindirizza alla pagina di autorizzazione
- è configurato un proxy con reindirizzamento
- Errori 4xx (Errore del client) – la richiesta è stata inviata, ma il server l'ha rifiutata a causa di problemi con i parametri, i dati o l'accesso.
Possibili cause:
- l'endpoint non esiste
- errore di autorizzazione
- formato dati non valido nel corpo della richiesta (JSON non valido)
- superamento del numero consentito di richieste al server
- Errori 5xx (Errore del server) – la richiesta è valida, ma il server ricevente non è riuscito a elaborarla.
Possibili cause:
- server temporaneamente non disponibile
- timeout di elaborazione
- Timeout superato (la richiesta ha impiegato troppo tempo ed è scaduta: il server ricevente non ha risposto entro 3 secondi)
Possibili cause:
- server sovraccarico
- problemi di rete
- URL non disponibile o non valido (questo URL non è consentito / impossibile trovare il dominio / il server non è raggiungibile)
Possibili cause:
- errore di battitura nell'URL del webhook
- viene utilizzato localhost o un IP interno
- dominio non configurato
- Problemi di connessione sicura (il server ha risposto tramite HTTP invece di HTTPS / la connessione non sembra sicura / impossibile stabilire una connessione sicura)
Possibili cause:
- impostazioni TLS errate
- Il server rifiuta o interrompe la connessione (il server ha rifiutato la connessione / il server ha chiuso la connessione in modo inatteso / la connessione è stata chiusa per inattività)
Possibili cause:
- server inattivo o sovraccarico
- tempi di elaborazione della richiesta troppo lunghi
- Il server ha inviato una risposta non valida (il server ha inviato una risposta non valida / il server si è comportato in modo inatteso)
Possibili cause:
- errori nel codice del server ricevente
- Errore sconosciuto (qualcosa è andato storto)
Possibili cause:
- errore temporaneo
- problema di rete
Per qualsiasi domanda, contatta il supporto.