Webhook

Funktionsweise

Wenn ein Incident-Event ausgelöst wird, sendet isthisthing.online eine POST-Anfrage mit JSON-Body an die von Ihnen konfigurierte URL. Wenn Sie ein Signing Secret angeben, enthält jede Anfrage einen HMAC-SHA256-Signatur-Header, damit Sie die Authentizität prüfen können.

1. Endpunkt vorbereiten

Ihr Server benötigt einen HTTP-Endpunkt, der:

• POST mit Content-Type: application/json akzeptiert.
• innerhalb von 10 Sekunden 2xx zurückgibt (sonst wird die Zustellung erneut versucht).

2. Integration hinzufügen

1. Öffnen Sie Integrations → New Integration.
2. Wählen Sie Webhook.
3. Füllen Sie die Felder aus:

Feld	Wert
Name	z. B. Production Webhook
Webhook URL	Ihr Endpunkt, z. B. https://api.example.com/hooks/incidents
Signing Secret	Optional. Wenn gesetzt, enthält jede Anfrage X-isthisthing.online-Signature.

4. Aktivieren Sie Trigger-Events und klicken Sie auf Save.

3. Signatur prüfen (empfohlen)

Wenn Sie ein Signing Secret gesetzt haben, sollten Sie jede eingehende Anfrage validieren:

const crypto = require('crypto');

function verify(body, secret, headerValue) {
  const expected = 'sha256=' +
    crypto.createHmac('sha256', secret).update(body).digest('hex');
  return crypto.timingSafeEqual(
    Buffer.from(expected),
    Buffer.from(headerValue)
  );
}

Payload-Schema

{
  "incidentId": "clx...",
  "eventType": "incident.created",
  "title": "API latency spike",
  "description": "p99 latency above 2 s for 5 minutes",
  "status": "OPEN",
  "source": "MONITOR",
  "monitorId": "clx...",
  "monitorName": "Production API",
  "monitorUrl": "https://api.example.com/health",
  "startedAt": "2026-04-08T12:00:00.000Z",
  "resolvedAt": null,
  "emittedAt": "2026-04-08T12:00:01.234Z",
  "workspaceId": "clx...",
  "workspaceName": "Acme Corp",
  "workspaceSlug": "acme",
  "incidentUrl": "https://app.isthisthing.online/en/acme/incidents/clx...",
  "workspaceUrl": "https://app.isthisthing.online/en/acme/dashboard"
}

Wiederholungsrichtlinie

Versuch	Verzögerung
1. Wiederholung	30 Sekunden
2. Wiederholung	2 Minuten
3. Wiederholung	10 Minuten

Nach drei fehlgeschlagenen Versuchen wird das Event nicht erneut zugestellt (dead letter).

Sicherheit

• Prüfen Sie immer den Header X-isthisthing.online-Signature.
• Verwenden Sie nur HTTPS-Endpunkte.
• Rotieren Sie das Signing Secret bei Kompromittierung.