Webhooks Gebruiken in een Headless CMS-contentarchitectuur

Je contenteditor publiceert een bijgewerkte prijspagina. Je Next.js-site is statisch gegenereerd en gedeployd op Vercel. Zonder webhooks toont de live site nog steeds de oude prijzen totdat iemand handmatig een rebuild triggert. Met webhooks vuurt de publicatiegebeurtenis een verzoek af naar Vercel's revalidatie-endpoint, de prijspagina rendert opnieuw en de CDN-cache wordt gewist — allemaal binnen 30 seconden nadat de editor op Publiceren heeft geklikt.

Wat ContentGrid Stuurt in een Webhook

ContentGrid's webhook-payload bevat het gebeurtenistype (entry.publish, entry.unpublish, entry.delete, asset.upload), de entry-ID, het contenttype, de locale en de omgeving. Dat is genoeg informatie om de gebeurtenis intelligent te routeren in je handler — je hoeft het CMS niet te bevragen om te weten wat er is gewijzigd.

Voorbeeldvelden in de payload: eventType, entryId, contentType, locale, environment, changedFields. De changedFields-array vertelt je handler precies welke velden zijn bijgewerkt, zodat je slimmere invalidatiebeslissingen kunt nemen.

Veelgebruikte Webhook-doelen

• Vercel revalidatie-API: Roep /api/revalidate?path=/blog/mijn-post aan om een specifieke pagina te herbouwen zonder een volledige site-deploy.
• Netlify build-hook: Trigger een volledige rebuild wanneer schema of globale content (navigatie, site-instellingen) wijzigt.
• Algolia-index: Push bijgewerkte content naar je zoekindex wanneer entries worden gepubliceerd of verwijderd.
• Slack-melding: Post in een #content-updates-kanaal wanneer content wordt gepubliceerd, zodat het team weet wat live is gegaan.
• CRM of analyse: Log content-publicatiegebeurtenissen voor attributie en experimenten bijhouden.

Een Betrouwbare Webhook-handler Bouwen

Je webhook-handler is een API-route — een Next.js edge-functie of een serverloze functie op Vercel of Netlify. Die ontvangt het POST-verzoek van ContentGrid, valideert de handtekening (ContentGrid ondertekent elke payload met een geheim), verwerkt de gebeurtenis en antwoordt snel met een 200-status. Voer geen trage bewerkingen synchroon uit in de handler. Zet zwaar werk — een Algolia-index herbouwen, batchmeldingen verzenden — in een wachtrij en verwerk het asynchroon.

Valideer de webhook-handtekening bij elk verzoek. ContentGrid bevat een X-ContentGrid-Signature-header met een HMAC-SHA256-hash van de payload. Wijs verzoeken af die niet overeenkomen met je geheim. Dit voorkomt dat kwaadwillenden rebuilds of index-updates triggeren door je handler-URL direct te raken.

Webhooks Testen in Ontwikkeling

Gebruik een tunneling-tool zoals ngrok om je lokale Next.js-devserver beschikbaar te stellen voor ContentGrid's webhook-levering. Registreer de ngrok-URL als webhook-endpoint in je ContentGrid space-instellingen en publiceer daarna een entry. Je ziet de volledige payload in je terminal en kunt je handler-logica itereren voordat je naar productie deployt.