Ga naar de inhoud
AchaduDevelopers
Operationele APIGa naar website ↗
Dashboard →
Achadu/Developers/Webhaken

Betrouwbare, ondertekende en traceerbare evenementen.

Ontvang wijzigingen in uw bedrijf zonder polling. Elke bezorging gaat door de speciale wachtrij, slaat pogingen op en is voorzien van een verifieerbare handtekening.

28 domeingebeurtenissen

Onderteken ze allemaal met * of kies alleen de gebeurtenissen die uw toepassing daadwerkelijk gebruikt.

offer.createdoffer.updatedoffer.archivedoffer.publishedsegment.createdsegment.updatedsegment.deletedcoupon.createdcoupon.updatedcoupon.archivedtemplate.createdtemplate.updatedtemplate.deletedschedule.createdschedule.updatedschedule.deletedschedule.executedmonitor.createdmonitor.updatedmonitor.deletedstore.updatedjourney.createdjourney.updatedjourney.deletedconversation.updatedconversation.closedconversation.repliedwebhook.test

Schema's met gebeurtenisversies

Elke envelop heeft api_version nodig. De catalogus bevat de schema-URL en biedt een voorbeeld om consumenten te valideren voordat een wijziging wordt gepubliceerd.

json
{
  "id": "evt_...",
  "type": "offer.updated",
  "api_version": "2026-08-31",
  "created_at": "2026-08-31T12:00:00.000Z",
  "data": { "offer_id": "off_..." }
}

Valideer vóór verwerking

Het geheim verschijnt slechts één keer. Bereken HMAC-SHA256 over de tijdstempel en het ruwe lichaam en vergelijk in constante tijd.

javascript
import { createHmac, timingSafeEqual } from "node:crypto";

const signed = `${timestamp}.${rawBody}`;
const expected = createHmac("sha256", process.env.ACHADU_WEBHOOK_SECRET)
  .update(signed)
  .digest("hex");
const received = signature.replace("sha256=", "");

if (!timingSafeEqual(Buffer.from(expected), Buffer.from(received))) {
  throw new Error("Invalid signature");
}

Duurzame levering

Wachtrij onafhankelijk van het webproces.
Maximaal zes pogingen voor tijdelijke fouten.
Time-out van 12 seconden per poging.
Geschiedenis met HTTP-status, fout en tijd.
Interne bestemmingen en privéadressen worden geblokkeerd.

Webhook Inspector

Open in het gebied Ontwikkelaars een levering om de payload, doelreactie, HTTP-status, duur, pogingen en volgende nieuwe poging te controleren. In hetzelfde paneel kunt u de gebeurtenis kopiëren en in de wachtrij plaatsen voor opnieuw verzenden.

Ruw lichaam bewaard voor foutopsporing.
Beperkte respons en geen geheimen.
Duur gemeten per poging.
Met Opnieuw verzenden wordt een nieuwe levering gemaakt die is gekoppeld aan dezelfde event_id.