Webhooks: delete-event, alle onderdelen en ondertekening volgens Standard Webhooks

Webhooks vertellen een gekoppeld systeem nu ook wanneer een record naar de prullenbak gaat, je kiest uit alle onderdelen die een webhook kunnen versturen, en elke levering is te controleren met de headers van de open standaard Standard Webhooks.

Details

• In het webhookformulier kies je uit alle onderdelen die een webhook kunnen versturen, met per onderdeel de bijbehorende gebeurtenissen. Een nieuwe of aangepaste webhook wordt weer goed opgeslagen, en filters werken op de veldnamen uit de API-documentatie.
• Gaat een record naar de prullenbak (via het CMS, een DELETE via de API of een import die het record niet meer bevat), dan wordt nu een delete-webhook verstuurd in plaats van een upsert. Terugzetten uit de prullenbak en bewerken blijven een upsert.
• Dit staat standaard aan voor alle projecten. Wil je het oude gedrag houden, waarbij een record in de prullenbak als upsert wordt verstuurd? Zet dan via het tandwiel boven het webhookoverzicht het vinkje "Delete-webhook versturen" uit.
• Let op: een webhook die alleen op upsert luistert, krijgt een record in de prullenbak niet meer binnen. Voeg in het webhookformulier een webhook met het event delete toe om die toch te ontvangen.
• De koppelingen met Spotler, Dotdigital en Personalize hebben automatisch een delete-webhook gekregen, zodat ze verwijderde producten blijven ontvangen.
• Elke levering bevat nu de headers webhook-id, webhook-timestamp en, als je een secret hebt ingesteld, webhook-signature. Een nieuwe poging voor dezelfde wijziging houdt hetzelfde webhook-id, zodat je dubbele leveringen eenvoudig herkent. De bestaande header X-Webhook-Signature blijft werken. Het secret stel je nu ook via de API in.
• Een proefverzoek via de API (zonder commit=true) verstuurt geen webhooks meer: alleen wijzigingen die echt worden opgeslagen, leiden tot een webhook.
• De webhook-guide beschrijft de nieuwe headers, met voorbeeldcode in PHP en Node.js om de handtekening te controleren.

Waarom dit belangrijk is

Een gekoppeld systeem, zoals een nieuwsbrieftool of een ERP, kon tot nu toe niet goed zien dat een product of klant was verwijderd. Met het delete-event blijft zo'n systeem vanzelf gelijk met je CMS. De standaardheaders maken het eenvoudiger om te controleren dat een webhook echt van jouw website komt, ook met kant-en-klare libraries.

Verwacht effect

Minder verouderde gegevens in gekoppelde systemen, en een eenvoudigere, veiligere verwerking van webhooks aan de ontvangende kant.