Configurare i webhook

Un webhook è un modo con cui VerifyPDF dice al tuo sistema che un risultato è pronto, invece di far chiedere al tuo sistema di continuo. Questo articolo spiega l’idea e come attivarla.

Cos’è un webhook, in parole semplici

Quando verifichi un documento, il risultato non è sempre pronto all’istante. Senza un webhook, il tuo sistema deve continuare a chiedere “è già pronto?”. Questo si chiama polling.

Un webhook ribalta la situazione. Dai a VerifyPDF un URL sul tuo sistema. Quando un risultato è pronto, VerifyPDF chiama quell’URL e ti invia l’esito. Il tuo sistema reagisce alla chiamata invece di interrogare di continuo l’API.

Imposta un URL webhook per chiave

Ogni chiave API può avere il proprio URL webhook. Lo imposti nella dashboard:

1. Accedi su secure.verifypdf.com e apri Developers nella barra laterale sinistra.
2. Scegli la chiave API che vuoi usare e modifica il suo URL webhook facendo clic sulla freccia per espandere la sezione di configurazione del webhook.
3. Salva. L’URL deve iniziare con https://.

Poiché l’URL si imposta per chiave, puoi indirizzare le notifiche di integrazioni diverse a endpoint diversi, ad esempio una chiave test verso un URL di test e una chiave live verso il tuo URL di produzione. Vedi Chiavi API test e live.

Per disattivare i webhook per una chiave, lascia vuoto il campo dell’URL e salva.

Cosa invia VerifyPDF

Quando una verifica termina, VerifyPDF chiama il tuo URL webhook così il tuo sistema può agire sul risultato, ad esempio aggiornando una pratica o avvisando un revisore. Per il payload esatto e per come verificare che una chiamata provenga davvero da VerifyPDF, consulta la documentazione API su /agents/ e la documentazione Developers dentro la dashboard.

Prossimi passi

• Ti serve prima una chiave? Vedi Generare e gestire le chiavi API.
• Vuoi l’intero flusso di invio? Vedi Verificare un documento con l’API.