Registri di consegna e test
Il pannello Webhook include un registro di consegna per ogni endpoint. Usalo per verificare l’arrivo degli eventi, diagnosticare errori e inviare nuovi dati di esempio senza attivare operazioni reali.
Visualizzare i registri di consegna
1
Apri Impostazioni → Webhook
Vai a
Dashboard → Settings → Webhooks.2
Espandi una riga webhook
Fai clic sul Registri di consegna su una scheda webhook. Mostra gli ultimi 50 tentativi, dal più recente.
3
Esamina ogni voce
Ogni riga mostra tipo di evento, codice di stato HTTP, tempo di risposta, data e ora ed eventuali messaggi di errore.
Campi del registro
| Campo | Descrizione |
|---|---|
| Evento | Il tipo di evento attivato (ad esempio post.saved) |
| Stato | Stato HTTP restituito dal tuo endpoint. null in caso di timeout o connessione rifiutata. |
| Tempo di risposta | Tempo di andata e ritorno in millisecondi, dall’invio all’ultimo byte della risposta. |
| Operazione riuscita | Spunta verde = HTTP 2xx. Croce rossa = qualsiasi altro risultato. |
| Errore | Messaggio di errore comprensibile per gli invii non riusciti (ad es. Request timed out (10s)). |
| Consegnato il | Data e ora UTC del tentativo di consegna. |
Inviare un evento di prova
1
Espandi la scheda webhook
In
Settings → Webhooks, trova il tuo webhook e fai clic su Invia evento di prova.2
Controlla il registro di consegna
L’invio di prova appare in cima ai registri entro pochi secondi. Verifica di vedere
200 stato.Gli eventi di prova sono vere richieste HTTP
L’evento di prova usa lo stesso percorso di un evento reale, compresa la firma HMAC. Il codice di verifica viene quindi esercitato completamente.
Nessun nuovo tentativo automatico
Ogni consegna viene tentata una sola volta. Il registro serve solo alla diagnostica; non esiste un pulsante per ripetere un evento live non riuscito. Dopo aver corretto un endpoint, usa Test per verificare la correzione.
Cause comuni di errore
| Errore / Stato | Causa probabile | Correggi |
|---|---|---|
Request timed out (10s) | Il server ha impiegato più di 10 s a rispondere | Torna 200 subito, poi elabora in modo asincrono |
401 | Verifica della firma non riuscita | Assicurati di leggere il corpo grezzo prima dell’analisi JSON |
404 | Il percorso URL dell’endpoint non esiste | Ricontrolla l’URL nelle impostazioni Webhook di Savebase |
500 | Errore non gestito nel ricevitore | Controlla i log del server per individuare l'eccezione |
| Connessione rifiutata / stato null | Il server è inattivo o l’URL è errato | Verifica che il server sia attivo e raggiungibile pubblicamente |