Webhook

Sådan virker det

Når en Incident-hændelse udløses, sender isthisthing.online en POST-forespørgsel med JSON-body til den URL, du konfigurerer. Hvis du angiver et signing secret, medfølger der en HMAC-SHA256-signatur-header i hver forespørgsel, så du kan verificere ægtheden.

1. Forbered dit endpoint

Din server skal have et HTTP-endpoint, der:

• Accepterer POST med Content-Type: application/json.
• Returnerer 2xx inden for 10 sekunder (ellers gentages leveringen).

2. Tilføj integrationen

1. Gå til Integrations → New Integration.
2. Vælg Webhook.
3. Udfyld felterne:

Field	Value
Name	F.eks. Production Webhook
Webhook URL	Dit endpoint, f.eks. https://api.example.com/hooks/incidents
Signing Secret	Valgfrit. Hvis sat, medfører hver forespørgsel X-isthisthing.online-Signature.

4. Aktivér trigger-hændelser og klik på Save.

3. Verificér signaturen (anbefalet)

Hvis du har angivet et signing secret, skal du validere hver indgående forespørgsel:

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-skema

{
  "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"
}

Gentagelsespolitik

Attempt	Delay
1st retry	30 seconds
2nd retry	2 minutes
3rd retry	10 minutes

Efter 3 mislykkede forsøg flyttes hændelsen til dead letter og gentages ikke længere.

Sikkerhed

• Verificér altid headeren X-isthisthing.online-Signature.
• Brug kun HTTPS-endpoints.
• Rotér signing secret, hvis det er kompromitteret.