Inviare un webhook di prova

Una prova è un invio webhook firmato effettivo, ma la notifica immediata conferma la creazione, non il successo presso il ricevitore. Usa la riga risultante e il log del ricevitore come ricevuta della consegna.

Passaggi

1. Apri Integrazioni → Webhook, scegli lo spazio di lavoro e trova la destinazione webhook desiderata tramite l’URL completo. L’azione richiede un ruolo con manage_settings; il percorso di prova è disponibile anche quando la destinazione è disattivata.
2. Prepara il ricevitore a registrare identificativi sicuri e a verificare la chiave segreta di firma corrente. Durante la prova non registrare il corpo completo della richiesta né la firma.
3. Scegli Invia un evento di prova. dosya crea un evento file.uploaded con file_id: "test_file", name: "test.txt", size: 12, folder_id: null, version: 1, is_new_version: false e test: true.
4. Leggi Test event sent — Check the deliveries log below for the result. Significa che è stata creata una riga whd_… e pianificato il primo tentativo; non indica che il servizio abbia risposto con 2xx.
5. Apri Invii recenti ed esamina la nuova riga file.uploaded. Confronta X-Dosya-Event-Id e X-Dosya-Delivery-Id con quelli del ricevitore, poi verifica che ci siano Completato, una risposta 2xx e il numero di tentativi previsto.
6. Se la riga è In attesa, usa Prossimo tentativo invece di inviare prove ripetute. Se è Errore, risolvi l’errore di risposta registrato o di trasporto, poi crea una nuova prova controllata e verificala da un capo all’altro.

Ogni prova può seguire la normale sequenza di sei tentativi e contribuisce agli errori di stato della destinazione webhook. dosya limita la creazione di prove a 20 richieste per utente in cinque minuti.

Risultato previsto

Un esempio firmato è visibile sul ricevitore e raggiunge Completato in Invii recenti. Il suo contenuto fisso test_file è chiaramente distinguibile da un caricamento reale e nessun segreto finisce nei log.

Impossibile completare la prova significa che dosya non ha potuto creare la richiesta di prova. Leggi l’errore restituito, verifica permessi e limiti di frequenza e non considerare l’assenza di una riga come errore del ricevitore.

La riga mostra Error. Controlla DNS, TLS, convalida HTTPS pubblico, comportamento dei reindirizzamenti o tempi di attesa sul ricevitore; un errore di trasporto non ha stato HTTP.

Guide correlate

• Creare un webhook
• Esaminare le consegne