Webhook

Nasıl çalışır

Bir Incident olayı tetiklendiğinde, isthisthing.online yapılandırdığınız URL'ye JSON gövdeli bir POST isteği gönderir. İmzalama anahtarı belirtirseniz her istek bir HMAC-SHA256 imza başlığı içerir.

1. Endpoint'inizi hazırlayın

Sunucunuzda şu özelliklere sahip bir HTTP endpoint gereklidir:

• Content-Type: application/json ile POST kabul etmeli.
• 10 saniye içinde 2xx döndürmeli (aksi halde yeniden denenir).

2. Entegrasyonu ekleyin

1. Integrations → Yeni Integration sayfasına gidin.
2. Webhook seçin.
3. Alanları doldurun:

Alan	Değer
Ad	ör. Production Webhook
Webhook URL	Endpoint'iniz, ör. https://api.example.com/hooks/incidents
Signing Secret	Opsiyonel. Ayarlanırsa her istekte X-isthisthing.online-Signature başlığı gönderilir.

4. Tetikleyici olayları etkinleştirin ve Kaydet'e tıklayın.

3. İmzayı doğrulayın (önerilen)

İmzalama anahtarı belirlediyseniz gelen her isteği doğrulayın:

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 şeması

{
  "incidentId": "clx...",
  "eventType": "incident.created",
  "title": "API gecikme artışı",
  "description": "p99 gecikme 5 dakikadır 2 s üzerinde",
  "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"
}

Yeniden deneme politikası

Deneme	Gecikme
1. deneme	30 saniye
2. deneme	2 dakika
3. deneme	10 dakika

3 başarısız denemeden sonra olay dead letter olarak işaretlenir.

Güvenlik

• X-isthisthing.online-Signature başlığını her zaman doğrulayın.
• Yalnızca HTTPS endpoint'leri kullanın.
• İmzalama anahtarı ifşa olursa hemen yenileyin.