Configurer des webhooks
Un webhook permet à VerifyPDF d'appeler ton URL quand un résultat est prêt, pour notifier ton système plutôt que de l'obliger à interroger. Une URL https par clé API.
Un webhook est un moyen pour VerifyPDF de dire à ton système qu’un résultat est prêt, au lieu que ton système le demande encore et encore. Cet article explique l’idée et comment l’activer.
Ce qu’est un webhook, en termes simples
Quand tu vérifies un document, le résultat n’est pas toujours prêt instantanément. Sans webhook, ton système doit sans cesse vérifier « c’est terminé ? ». C’est ce qu’on appelle l’interrogation.
Un webhook renverse les choses. Tu donnes à VerifyPDF une URL sur ton propre système. Quand un résultat est prêt, VerifyPDF appelle cette URL et t’envoie l’issue. Ton système réagit à l’appel au lieu d’interroger pour détecter les changements.
Définis une URL de webhook par clé
Chaque clé API peut avoir sa propre URL de webhook. Tu la définis dans le tableau de bord :
- Connecte-toi sur secure.verifypdf.com et ouvre Développeurs dans la barre latérale de gauche.
- Choisis la clé API que tu veux utiliser et modifie son URL de webhook.
- Enregistre. L’URL doit commencer par https://.
Comme l’URL est définie par clé, tu peux router les notifications de différentes intégrations vers différents points de terminaison, par exemple une clé test pointée vers une URL de test et une clé live vers ton URL de production. Voir Clés API de test et live.
Pour désactiver les webhooks d’une clé, laisse le champ d’URL vide et enregistre.
Ce que VerifyPDF envoie
Quand une vérification se termine, VerifyPDF appelle ton URL de webhook pour que ton système puisse agir sur le résultat, par exemple mettre à jour un dossier ou alerter un examinateur. Pour la charge utile exacte et pour vérifier qu’un appel provient bien de VerifyPDF, vois la référence de l’API sur /agents/ et la documentation Développeurs dans le tableau de bord.
Et après
- Tu as d’abord besoin d’une clé ? Voir Générer et gérer des clés API.
- Tu veux tout le flux d’envoi ? Voir Vérifier un document avec l’API.