Zum Hauptinhalt springen

Übersicht

Webhooks ermöglichen es Ihnen, bei jedem Abschluss einer Konvertierung eine HTTP-POST-Benachrichtigung an Ihren eigenen Endpunkt zu erhalten. Nutzen Sie sie, um Workflows in Zapier, Make, n8n oder einem beliebigen benutzerdefinierten Backend auszulösen.
Webhooks sind eine Funktion des PRO-Plans. Jeder Nutzer kann bis zu 3 Webhook-Endpunkte registrieren.

Einrichtung

  1. Öffnen Sie die Web2MD-Erweiterung und gehen Sie zu Settings.
  2. Scrollen Sie zum Abschnitt Webhooks.
  3. Geben Sie Ihre Endpunkt-URL ein und klicken Sie auf Add Webhook.
  4. Kopieren Sie das Signing Secret — Sie benötigen es, um eingehende Anfragen zu verifizieren.

Payload

Wenn eine Konvertierung abgeschlossen ist, sendet Web2MD eine POST-Anfrage an Ihren Endpunkt mit folgendem JSON-Body:

Sicherheit

Jede Webhook-Anfrage enthält einen X-Web2MD-Signature-Header mit einer HMAC-SHA256-Signatur des rohen Request-Bodys, signiert mit dem Signing Secret Ihres Webhooks.
Überprüfen Sie die Signatur immer, bevor Sie einen Webhook verarbeiten. Dies verhindert, dass Angreifer gefälschte Anfragen an Ihren Endpunkt senden können.

Verifizierungsbeispiel (Node.js)

Verwenden Sie crypto.timingSafeEqual anstelle von ===, um Timing-Angriffe beim Vergleich von Signaturen zu verhindern.

Wiederholungsverhalten

Wenn beide Versuche fehlschlagen (Nicht-2xx-Antwort oder Timeout), wird die Zustellung verworfen. Web2MD wiederholt die Zustellung nicht über diesen einen Wiederholungsversuch hinaus.

Anwendungsfälle

Zapier / Make / n8n

Verwenden Sie einen Webhook-Trigger in Ihrer Automatisierungsplattform, um einen Workflow zu starten, sobald eine Seite konvertiert wird — posten Sie in Slack, fügen Sie eine Zeile zu einer Tabelle hinzu oder speichern Sie in Notion.

Slack-Benachrichtigungen

Senden Sie eine Nachricht an einen Slack-Kanal, jedes Mal wenn ein Teammitglied eine Seite konvertiert, damit alle auf dem Laufenden bleiben.

Automatisches Speichern in externem Speicher

Rufen Sie das vollständige Markdown über die REST API ab (mithilfe der conversionId) und speichern Sie es in S3, Google Drive oder Ihrer eigenen Datenbank.

Analytics-Pipeline

Verfolgen Sie Konvertierungsvolumen und Inhaltstypen, indem Sie Webhook-Ereignisse an Ihr Analytics-Backend weiterleiten.

Webhooks testen

Verwenden Sie während der Entwicklung ein Tool wie webhook.site oder ngrok, um einen lokalen Endpunkt bereitzustellen und eingehende Payloads zu prüfen, bevor Sie Ihren Handler in Produktion nehmen.