Webhook basati su eventi
Iscrivi endpoint a eventi di file, servizi, moduli, firme e processi.
Capacità
Automazione e webhook
Collega azioni Cloud tramite API e webhook firmati con cronologia e nuovi tentativi.
Descrizione
Collega azioni Cloud tramite API e webhook firmati con cronologia e nuovi tentativi.
Funzionalità
Cosa permette di fare Automazione e webhook
Firme HMAC
Verifica che i payload provengano da Apification e non siano stati alterati.
Cronologia consegne
Consulta URL, data, stato e corpo della risposta per ogni consegna.
Nuovi tentativi automatici e manuali
Ripeti errori temporanei secondo le regole o dal portale.
Operazioni guidate da API
Automatizza account, risorse Cloud e configurazione supportati.
Comandi idempotenti
Evita che i retry di rete ripetano la stessa azione di business.
Elaborazione asincrona
Esegui importazioni, trasformazioni e lavori provider in background.
Stati di errore dettagliati
Associa errori provider, validazione e processo al lavoro che li ha generati.
Statistiche di uso e consegna
Misura esecuzioni, consegne riuscite o fallite, tentativi e consumo.
Ciclo dell’evento
Progettare per verifica, tentativi e recupero
Un’automazione affidabile tratta la consegna come un processo con stato.
-
01 Scegliere l’evento
Sottoscrivi solo cambiamenti elaborabili dal ricevente.
-
02 Verificare la richiesta
Convalida HMAC prima di leggere o salvare il payload.
-
03 Elaborare in modo idempotente
Usa identificatori stabili contro azioni duplicate.
-
04 Osservare e recuperare
Controlla le consegne e ripeti gli errori temporanei.
Dettaglio operativo
Come funziona Automazione e webhook nella pratica
L’automazione unisce comandi autenticati, eventi firmati, elaborazione in background ed evidenze operative senza trasformare i tentativi in lavoro duplicato.
Gli eventi richiedono un contratto esplicito
Il ricevente deve conoscere tipo, risorsa, account, momento e versione del payload.
La consegna ha un ciclo di vita
Tentativi, risposte, tempi e ripetizioni restano collegati per distinguere errori temporanei e permanenti.
Comandi e job richiedono trattamenti diversi
L’API può accettare un comando mentre importazioni e trasformazioni continuano in background.
Il monitoraggio fa parte del flusso
Successi, errori ripetuti, durata e consumo vanno controllati insieme.
Domande frequenti
Domande su Automazione e webhook
Il catalogo supportato comprende le modifiche rilevanti del Cloud, dell’elaborazione, delle consegne e del ciclo di vita dei servizi.
Le richieste webhook includono una firma generata con il segreto configurato, che permette di verificarne l’autenticità.
Il registro conserva tentativi, stato, risposta e tempi per diagnosi e nuovi tentativi controllati.
Non affidarti solo all’arrivo; usa date, stato della risorsa e identificatori stabili.
Dopo verifica e accettazione persistente; l’elaborazione lunga deve continuare in modo asincrono.
Salva l’identificatore stabile e rendi idempotente l’operazione prima della risposta.