Een API vraag je iets. Een webhook vertelt het je uit zichzelf.
Een webhook is een automatisch bericht dat het ene systeem naar het andere stuurt zodra er iets gebeurt: een bestelling geplaatst, een betaling geslaagd, een formulier verzonden. Waar je bij een API zelf moet vragen of er nieuws is, meldt een webhook zich uit zichzelf. Dat scheelt vertraging en onnodig verkeer.
IN GEWONE TAAL
Vragen of verteld krijgen
Zonder webhooks moet een systeem periodiek vragen: zijn er nieuwe bestellingen? Elke minuut opnieuw. Meestal is het antwoord nee, en dat kost verkeer en tijd.
Met een webhook draai je dat om. Zodra er een bestelling is, stuurt de webshop een bericht naar je boekhouding. Geen wachttijd, geen zinloze vragen.
In de praktijk gebruik je beide. Webhooks voor gebeurtenissen die direct moeten doorkomen, en een API om gegevens op te halen wanneer jij ze nodig hebt.
WAAROM HET UITMAAKT
Waar het misgaat
Webhooks zijn eenvoudig tot het bericht niet aankomt. Ligt het ontvangende systeem er even uit, dan is de melding weg — tenzij daar rekening mee is gehouden.
Daarom bouwen wij ontvangst altijd met een wachtrij en herhaalpogingen. Lukt het uiteindelijk niet, dan krijg je een melding. Stil verlies van gegevens is het enige onacceptabele scenario.
- Herhaalpogingen — een gemiste melding moet opnieuw geprobeerd worden.
- Controleerbare afzender — zodat niet iedereen berichten kan sturen.
- Dubbele berichten opvangen — leveranciers sturen soms twee keer; dat mag niet twee facturen geven.
- Zichtbaar logboek — je wilt kunnen terugkijken wat er binnenkwam.
- Melding bij falen — liever een mailtje dan een gat in je administratie.
VEELGESTELDE VRAGEN
Meer over een webhook
Wat is het verschil met een API-koppeling?
Een API gebruik je om iets op te vragen of te versturen op het moment dat jij dat wilt. Een webhook is de omgekeerde richting: het andere systeem meldt zich zodra er iets gebeurt. In een koppeling gebruik je meestal allebei.
Wat als een webhook mislukt?
Bij een goed gebouwde koppeling komt het bericht in een wachtrij en wordt het opnieuw geprobeerd, met oplopende tussenpozen. Lukt het dan nog niet, dan volgt een melding aan een mens. Dat foutpad is belangrijker dan het gelukkige pad.
Is een webhook veilig?
Mits gecontroleerd wordt wie hem stuurt. Een open ontvangstadres kan door iedereen aangeroepen worden. Wij verifiëren elk binnenkomend bericht met een gedeeld geheim of handtekening van de leverancier.
VERDER LEZEN
Meer over dit onderwerp
Natuurlijk doorlezen over dit onderwerp.
Gegevens die direct doorkomen?
Vertel welke systemen je gebruikt. Wij zoeken uit wat er automatisch kan en wat het oplevert.