Webhooks

Ontvang realtime meldingen wanneer gegevens veranderen. Brutlers stuurt HTTP-POST-verzoeken naar uw geregistreerde URL.

Webhook instellen

Registreer een URL die HTTP-POST-verzoeken kan ontvangen. U ontvangt een secret voor handtekeningverificatie.

POST

/api/vendor/webhooks

Registreer een nieuwe webhook. Het secret wordt slechts één keer weergegeven.

bash

curl -X POST https://brutlers.com/api/vendor/webhooks \
  -H "X-Api-Key: brut_your_api_key_here" \
  -H "Content-Type: application/json" \
  -d '{
    "url": "https://meine-app.de/webhooks/brutlers",
    "events": ["order.created", "order.status_changed"]
  }'

Maximaal 5 webhooks per leverancier

Beschikbare events

Event	Description
order.created	Nieuwe opdracht aangemaakt
order.status_changed	Opdrachtsstatus gewijzigd
inquiry.received	Nieuwe aanvraag ontvangen
appointment.confirmed	Afspraak bevestigd
appointment.cancelled	Afspraak geannuleerd
customer.created	Nieuwe klant aangemaakt

Payload-formaat

Elk webhook-verzoek bevat een JSON-body met het event-type en de bijbehorende gegevens.

json

{
  "event": "order.status_changed",
  "data": {
    "id": "clx1234567890abcdef",
    "status": "FITTING_READY",
    "previousStatus": "IN_PRODUCTION",
    "customerId": "clx0987654321fedcba",
    "updatedAt": "2026-04-15T10:00:00.000Z"
  },
  "timestamp": "2026-04-15T10:00:01.234Z"
}

Handtekeningverificatie

Elk verzoek bevat een HMAC-SHA256-handtekeningheader. Verifieer de handtekening om te bevestigen dat het verzoek afkomstig is van Brutlers.

Header

X-Brutlers-Signature

javascript

import { createHmac } from "crypto";

function verifySignature(body, signature, secret) {
  const expected = createHmac("sha256", secret)
    .update(body)
    .digest("hex");
  return signature === expected;
}

// Express/Next.js example
app.post("/webhooks/brutlers", (req, res) => {
  const signature = req.headers["x-brutlers-signature"];
  const body = JSON.stringify(req.body);

  if (!verifySignature(body, signature, process.env.WEBHOOK_SECRET)) {
    return res.status(401).send("Invalid signature");
  }

  const { event, data } = req.body;
  console.log(`Event: ${event}`, data);
  res.status(200).send("OK");
});

Retry-beleid

Bij fouten (status ≠ 2xx of time-out) wordt de webhook tot 3 keer herhaald:

11e poging: na 1 minuut
22e poging: na 5 minuten
33e poging: na 30 minuten

Webhookbeheer

GET

/api/vendor/webhooks

Registreer een nieuwe webhook. Het secret wordt slechts één keer weergegeven.

PUT

/api/vendor/webhooks/:id

Werk de URL, events of status van een webhook bij.

DELETE

/api/vendor/webhooks/:id

Verwijder een webhook en alle bijbehorende afleverlogboeken.

Webhook instellen

Registreer een URL die HTTP-POST-verzoeken kan ontvangen. U ontvangt een secret voor handtekeningverificatie.

POST

/api/vendor/webhooks

Registreer een nieuwe webhook. Het secret wordt slechts één keer weergegeven.

bash

curl -X POST https://brutlers.com/api/vendor/webhooks \
  -H "X-Api-Key: brut_your_api_key_here" \
  -H "Content-Type: application/json" \
  -d '{
    "url": "https://meine-app.de/webhooks/brutlers",
    "events": ["order.created", "order.status_changed"]
  }'

Maximaal 5 webhooks per leverancier

Event

Description

order.created

Nieuwe opdracht aangemaakt

order.status_changed

Opdrachtsstatus gewijzigd

inquiry.received

Nieuwe aanvraag ontvangen

appointment.confirmed

Afspraak bevestigd

appointment.cancelled

Afspraak geannuleerd

customer.created

Nieuwe klant aangemaakt

Payload-formaat

Elk webhook-verzoek bevat een JSON-body met het event-type en de bijbehorende gegevens.

json

{
  "event": "order.status_changed",
  "data": {
    "id": "clx1234567890abcdef",
    "status": "FITTING_READY",
    "previousStatus": "IN_PRODUCTION",
    "customerId": "clx0987654321fedcba",
    "updatedAt": "2026-04-15T10:00:00.000Z"
  },
  "timestamp": "2026-04-15T10:00:01.234Z"
}

Handtekeningverificatie

Elk verzoek bevat een HMAC-SHA256-handtekeningheader. Verifieer de handtekening om te bevestigen dat het verzoek afkomstig is van Brutlers.

Header

X-Brutlers-Signature

javascript

import { createHmac } from "crypto";

function verifySignature(body, signature, secret) {
  const expected = createHmac("sha256", secret)
    .update(body)
    .digest("hex");
  return signature === expected;
}

// Express/Next.js example
app.post("/webhooks/brutlers", (req, res) => {
  const signature = req.headers["x-brutlers-signature"];
  const body = JSON.stringify(req.body);

  if (!verifySignature(body, signature, process.env.WEBHOOK_SECRET)) {
    return res.status(401).send("Invalid signature");
  }

  const { event, data } = req.body;
  console.log(`Event: ${event}`, data);
  res.status(200).send("OK");
});