Webhooks en real-time geocoding

Voor sommige use cases wil je niet wachten op een response. Met webhooks kun je geocoding requests asynchroon verwerken en notificaties ontvangen wanneer resultaten klaar zijn.

Wanneer webhooks gebruiken?

• Lange batch jobs die uren kunnen duren
• Event-driven architecturen
• Microservices die los gekoppeld moeten zijn
• Background processing zonder timeout risico

Webhook endpoint implementatie

// Express.js webhook handler
app.post('/webhooks/geocode', (req, res) => {
  const { event, data, job_id } = req.body;

  // Verify webhook signature
  const signature = req.headers['x-georex-signature'];
  if (!verifySignature(req.body, signature)) {
    return res.status(401).send('Invalid signature');
  }

  // Acknowledge immediately
  res.status(200).send('OK');

  // Process async
  processGeocodeResult(event, data, job_id);
});

Samenvatting

Webhooks maken het mogelijk om geocoding te integreren in moderne, event-driven systemen. Je applicatie blijft responsive terwijl zware verwerking op de achtergrond draait.