Webhooks instellen
Met een webhook roept VerifyPDF je eigen URL aan zodra een verificatieresultaat klaar is, zodat je systeem een melding krijgt in plaats van te pollen. Stel een https-webhook-URL in per API-sleutel.
Een webhook is een manier voor VerifyPDF om je systeem te vertellen dat een resultaat klaar is, in plaats van dat je systeem het steeds opnieuw vraagt. Dit artikel legt het idee uit en hoe je het aanzet.
Wat een webhook is, in gewone woorden
Wanneer je een document verifieert, is het resultaat niet altijd direct klaar. Zonder een webhook moet je systeem steeds blijven controleren: “is het al klaar?” Dat heet pollen.
Een webhook draait dat om. Je geeft VerifyPDF een URL op je eigen systeem. Wanneer een resultaat klaar is, roept VerifyPDF die URL aan en stuurt de uitkomst naar jou. Je systeem reageert op de aanroep in plaats van te pollen op wijzigingen.
Stel een webhook-URL in per sleutel
Elke API-sleutel kan zijn eigen webhook-URL hebben. Je stelt hem in het dashboard in:
- Log in op secure.verifypdf.com en open Developers in de linkerzijbalk.
- Kies de API-sleutel die je wilt gebruiken en bewerk zijn webhook-URL.
- Sla op. De URL moet beginnen met https://.
Omdat de URL per sleutel wordt ingesteld, kun je meldingen van verschillende integraties naar verschillende endpoints sturen, bijvoorbeeld een test-sleutel gericht op een test-URL en een live-sleutel op je productie-URL. Zie Test- versus live-API-sleutels.
Om webhooks voor een sleutel uit te zetten, laat je het URL-veld leeg en sla je op.
Wat VerifyPDF verstuurt
Wanneer een verificatie klaar is, roept VerifyPDF je webhook-URL aan zodat je systeem op het resultaat kan reageren, bijvoorbeeld door een dossier bij te werken of een beoordelaar te waarschuwen. Voor de exacte payload en hoe je controleert dat een aanroep echt van VerifyPDF kwam, zie de API-referentie op /agents/ en de Developers-documentatie in het dashboard.
Wat je daarna kunt doen
- Heb je eerst een sleutel nodig? Zie API-sleutels genereren en beheren.
- Wil je het volledige verzendverloop? Zie Een document verifiëren met de API.