Zum Inhalt springen
AchaduDevelopers
Achadu/Developers/Webhooks

Zuverlässige, signierte und nachverfolgbare Ereignisse.

Erhalten Sie Änderungen an Ihrem Betrieb ohne Abfrage. Jede Lieferung durchläuft die dedizierte Warteschlange, speichert Versuche und trägt eine überprüfbare Signatur.

28 Domain-Events

Signieren Sie sie alle mit * oder wählen Sie nur die Ereignisse aus, die Ihre Anwendung tatsächlich nutzt.

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

Ereignisversionierte Schemata

Jeder Umschlag benötigt api_version. Der Katalog stellt die Schema-URL bereit und bietet ein Beispiel zur Validierung von Verbrauchern vor der Veröffentlichung einer Änderung.

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

Vor der Verarbeitung validieren

Das Geheimnis erscheint nur einmal. Berechnen Sie HMAC-SHA256 über den Zeitstempel und den Rohkörper und vergleichen Sie ihn in konstanter Zeit.

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");
}

Dauerhafte Lieferung

Warteschlange unabhängig vom Webprozess.
Bis zu sechs Versuche bei vorübergehenden Fehlern.
Timeout von 12 Sekunden pro Versuch.
Verlauf mit HTTP-Status, Fehler und Uhrzeit.
Interne Ziele und private Adressen werden blockiert.

Webhook Inspector

Öffnen Sie im Entwicklerbereich eine Lieferung, um Nutzlast, Zielantwort, HTTP-Status, Dauer, Versuche und den nächsten Wiederholungsversuch zu überprüfen. Im selben Bereich können Sie das Ereignis kopieren und einen erneuten Versand in die Warteschlange stellen.

Rohtext zum Debuggen aufbewahrt.
Begrenzte Reaktion und keine Geheimnisse.
Gemessene Dauer pro Versuch.
„Resend“ erstellt eine neue Lieferung, die mit derselben event_id verknüpft ist.