Cosa sono i webhook e come si differenziano dalle richieste API?
I webhook sono un meccanismo che consente a un'applicazione di inviare informazioni a un'altra applicazione quando si verifica un evento particolare.
Vengono comunemente utilizzati per connettere sistemi software e supportare processi aziendali basati su eventi.
A differenza di una richiesta API tradizionale, in cui un sistema richiede attivamente informazioni, un webhook è generalmente inviato dal sistema in cui si è verificato l'evento.
Come funziona un webhook?
Un processo tipico di webhook implica i seguenti passaggi:
1. Si verifica un evento in un'applicazione esterna.
2. L'applicazione identifica che l'evento corrisponde a un abbonamento webhook configurato.
3. L'applicazione invia una richiesta HTTP a un endpoint designato.
4. Il sistema ricevente convalida e elabora la richiesta.
5. Il sistema ricevente restituisce una risposta HTTP appropriata.
Ad esempio, un'applicazione aziendale può inviare un webhook quando viene creata un'ordine o quando cambia lo stato di un pagamento.
Questi sono esempi generali di webhook, non una conferma che un particolare evento sia supportato da Polyosync.
Qual è la differenza tra API e webhook?
Richiesta API
Un sistema avvia una richiesta per recuperare informazioni o eseguire un'operazione.
Webhook
Un sistema invia una notifica di evento a un altro sistema, di solito senza attendere che il sistema ricevente richieda le informazioni.
Entrambi gli approcci possono essere utilizzati insieme.
A cosa servono i webhook?
Le applicazioni comuni includono:
1. Notifiche basate su eventi.
2. Aggiornamenti di ordini e transazioni.
3. Eventi di attività dei clienti.
4. Cambiamenti di stato in applicazioni esterne.
5. Coordinamento tra sistemi aziendali.
6. Attivazione di elaborazione a valle quando supportato.
I webhook possono attivare flussi di lavoro Polyosync?
Questo dipende dalla funzionalità di ricezione e attivazione del webhook implementata per il flusso di lavoro pertinente.
L'esistenza di una funzionalità webhook in un servizio esterno non significa automaticamente che Polyosync possa ricevere o elaborare ogni evento.
Polyosync può inviare webhook ad altre applicazioni?
La funzionalità di webhook in uscita deve essere supportata e configurata per l'operazione prevista.
I webhook in entrata e in uscita sono capacità separate.
I webhook vengono sempre consegnati istantaneamente?
Non necessariamente.
Il tempo di consegna dipende dal servizio di invio, dalle condizioni di rete, dalle politiche di ripetizione e dal comportamento di elaborazione.
I webhook sono garantiti per arrivare solo una volta?
No.
A seconda del fornitore, gli eventi possono essere ripetuti o consegnati più di una volta.
I sistemi che elaborano i webhook dovrebbero tenere conto di possibili eventi duplicati.
I webhook contengono informazioni sensibili?
Possono.
I payload dei webhook possono includere dati personali, commerciali o operativi.
Solo le informazioni necessarie per l'operazione prevista dovrebbero essere elaborate.
Approccio raccomandato
Prima di utilizzare i webhook, determinare la fonte dell'evento, il payload previsto, il metodo di autenticazione, l'endpoint di ricezione e il comportamento di elaborazione richiesto.
Valida il flusso completo dell'evento prima di fare affidamento su di esso per operazioni critiche per l'azienda.