Modifica, ruota, disabilita o elimina un webhook

Modifica l'URL, il nome o gli eventi di un endpoint webhook Notiondesk, ruota il suo segreto di firma, disabilitalo o abilitalo, oppure eliminalo.

3 min di lettura

È possibile modificare un endpoint in qualsiasi momento dalla sua pagina: modificarne l'URL, il nome o gli eventi, ruotare la chiave segreta di firma, disattivarlo temporaneamente o eliminarlo.

Percorso rapido: vai su Impostazioni > Sviluppatori > Webhooks e fai clic sull'endpoint. Modificalo e fai clic su Salva modifiche oppure usa Altre azioni ( ... ) per disabilitarlo o eliminarlo.

Prima di iniziare

Sei il proprietario dell'area di lavoro o un amministratore. Altri ruoli non possono aprire la pagina dei webhook.

Modifica un endpoint

  1. Vai su Impostazioni > Sviluppatori > Webhooks e fai clic sull'endpoint.
  1. Modifica l' URL o il nome .
  1. Nella sezione Eventi , fai clic su Aggiungi un evento per aggiungerne altri oppure fai clic sulla crocetta accanto a un evento per rimuoverlo. Mantieni almeno un evento.
  1. Fai clic su Salva modifiche .

I nuovi eventi utilizzano le impostazioni aggiornate. Quando si modifica l'URL, il conteggio degli errori riparte da zero e i tentativi già pianificati vengono indirizzati al nuovo URL.

Ruota il segreto di firma

Ruota il segreto se potrebbe essere trapelato o se lo hai perso.

  1. Nella pagina dell'endpoint, sotto "Segreto di firma" , fare clic su "Ruota" .
  1. Fai clic su Ruota per confermare.
  1. Fai clic su Copia , salva il nuovo segreto sul tuo server, quindi fai clic su L'ho salvato .
La vecchia chiave segreta smette di funzionare immediatamente. Ogni richiesta inviata dopo la rotazione, inclusi i tentativi di ripetizione, viene firmata con la nuova chiave segreta, quindi è necessario aggiornare il server contemporaneamente.

Verificare che un webhook provenga da Notiondesk mostra come il server utilizza il segreto.

Disabilitare o abilitare un endpoint

Disabilitare un endpoint per interrompere l'invio di eventi senza eliminarlo, ad esempio mentre si lavora sul server.

  1. Nella pagina dell'endpoint, fai clic su Altre azioni ( ... ).
  1. Fai clic su Disabilita .

L'endpoint risulta disabilitato . Mentre è disabilitato:

  • Non riceve alcun evento. Gli eventi che si verificano nel frattempo non vengono salvati e non vengono mai inviati, nemmeno dopo averlo riattivato.
  • I tentativi di ripetizione già programmati sono stati annullati.
  • È ancora possibile fare clic su Invia evento di prova .

Per riattivarlo, fai clic su Altre azioni ( ... ), quindi su Abilita . Riceverà di nuovo nuovi eventi e il conteggio degli errori ricomincerà da capo.

Se l'endpoint risulta in pausa , Notiondesk lo ha disattivato dopo ripetuti errori. Fai clic su Riprendi quando il server funziona. La sezione "Verifica le consegne dei webhook e risolvi gli errori" spiega perché gli endpoint vengono messi in pausa.

Eliminare un endpoint

  1. Nella pagina dell'endpoint, fai clic su Altre azioni ( ... ).
  1. Fai clic su Elimina .
  1. Fai clic su Elimina per confermare.
L'eliminazione è irreversibile. Il registro di consegna dell'endpoint viene eliminato e gli eventi in coda non vengono inviati.

Domande frequenti

Perdo gli eventi quando un endpoint è disabilitato?

Sì. Gli eventi che si verificano mentre è disabilitato non vengono mai inviati. Se devi solo modificare l'URL o gli eventi, modifica direttamente l'endpoint.

Posso vedere il vecchio segreto della firma dopo la rotazione?

No. Ogni segreto viene mostrato una sola volta, quando si aggiunge l'endpoint o si ruota il segreto. La pagina dell'endpoint mostra solo i suoi primi caratteri.

La modifica degli eventi influisce sulle consegne precedenti?

No. Le consegne precedenti rimangono in "Consegne recenti" . Solo gli eventi che si verificano dopo il salvataggio utilizzano il nuovo elenco.

È possibile ripristinare un endpoint eliminato?

No. Aggiungi un nuovo endpoint con lo stesso URL e gli stessi eventi. Otterrà un nuovo segreto di firma.

Articoli correlati

Questa pagina è stata utile?

Still need help? Ask us