Bildirim olayı

Bildirim adresinize gönderilen imzalı gövde. İmza `X-DarkRadar-Signature` başlığında.

Alanlar

idstring
Teslimin kimliği (`evt_…`); `X-DarkRadar-Delivery` başlığıyla aynı. Aynı kimliği ikinci kez alırsanız işlemeyin.

typestring
Olay türü: `leak.created`, `leak.shared` (panelden elle paylaşım), `scan.finished`, `scan.failed`, `hunter.finding.created`, `webhook.test`.

createdAtstring
Olayın gönderilmek üzere oluşturulduğu zaman (ISO 8601).

Olaya göre değişen içerik. Sızıntı olaylarında olay alanları, tarama olaylarında tarama alanları.

data.eventIdstring
Sızıntı olayı kimliği — `GET /v1/leak-events/{eventId}` ile ayrıntı alınır. (sızıntı olayları)

data.leakTypestring
Sızıntının neyle eşleştiği: `domain`, `email`, `username`, `ip`, `hwid`, `application`. (sızıntı olayları)

data.typestring
Kimin sızıntısı: `employee`, `customer` (360), `third_party`. (sızıntı olayları)

data.severitystring
Önem: `critical`, `high`, `medium`, `low`, `unknown`. (sızıntı olayları)

data.statusstring
Sızıntı olaylarında olayın durumu (`open` …); tarama olaylarında `completed` ya da `failed`.

data.eventDatestring
Sızıntının gerçekleştiği tarih (bulaşma tarihi). (sızıntı olayları)

data.stealerFamilystring
Hırsız yazılım ailesi. (sızıntı olayları)

data.groupIdstring
İlgili koruma kaynağı grubu.

data.scanIdstring
Tarama kimliği — `GET /v1/scans/{scanId}`. (tarama olayları)

data.completedAtstring
Taramanın bittiği zaman. (tarama olayları)

data.statsobject
Tarama sonuç sayıları; başarısız taramada sıfır. (tarama olayları)

data.stats.totalMatchesnumber
Toplam eşleşme.

data.stats.newMatchesnumber
Bu taramada ilk kez bulunan eşleşme.

data.stats.severitiesobject
Önem düzeyine göre eşleşme sayıları.

data.stats.severities.criticalnumber
Kritik.

data.stats.severities.highnumber
Yüksek.

data.stats.severities.mediumnumber
Orta.

data.stats.severities.lownumber
Düşük.

data.stats.severities.infonumber
Bilgi.

data.stats.severities.unknownnumber
Bilinmeyen.

data.messagestring
Açıklama. (yalnız `webhook.test`)

data.targetIdstring
Yeni bulgu çıkan izleme hedefi — `GET /v1/hunter/findings?targetId=…`. (`hunter.finding.created`)

data.targetKindstring
Hedef türü (ör. `domain`, `email`). (`hunter.finding.created`)

data.newFindingsnumber
Bu taramada eklenen bulgu sayısı; `data.severity` en yüksek önemdir. (`hunter.finding.created`)

JSON şeması

{
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "$id": "https://darkradar.com/docs/schemas/webhook-event.schema.json",
  "title": "Bildirim olayı",
  "description": "Bildirim adresinize gönderilen imzalı gövde. İmza `X-DarkRadar-Signature` başlığında.",
  "type": "object",
  "properties": {
    "id": {
      "type": "string",
      "description": "Teslimin kimliği (`evt_…`); `X-DarkRadar-Delivery` başlığıyla aynı. Aynı kimliği ikinci kez alırsanız işlemeyin."
    },
    "type": {
      "type": "string",
      "description": "Olay türü: `leak.created`, `leak.shared` (panelden elle paylaşım), `scan.finished`, `scan.failed`, `hunter.finding.created`, `webhook.test`."
    },
    "createdAt": {
      "type": "string",
      "description": "Olayın gönderilmek üzere oluşturulduğu zaman (ISO 8601)."
    },
    "data": {
      "type": "object",
      "description": "Olaya göre değişen içerik. Sızıntı olaylarında olay alanları, tarama olaylarında tarama alanları.",
      "properties": {
        "eventId": {
          "type": "string",
          "description": "Sızıntı olayı kimliği — `GET /v1/leak-events/{eventId}` ile ayrıntı alınır. (sızıntı olayları)"
        },
        "leakType": {
          "type": "string",
          "description": "Sızıntının neyle eşleştiği: `domain`, `email`, `username`, `ip`, `hwid`, `application`. (sızıntı olayları)"
        },
        "type": {
          "type": "string",
          "description": "Kimin sızıntısı: `employee`, `customer` (360), `third_party`. (sızıntı olayları)"
        },
        "severity": {
          "type": "string",
          "description": "Önem: `critical`, `high`, `medium`, `low`, `unknown`. (sızıntı olayları)"
        },
        "status": {
          "type": "string",
          "description": "Sızıntı olaylarında olayın durumu (`open` …); tarama olaylarında `completed` ya da `failed`."
        },
        "eventDate": {
          "type": "string",
          "description": "Sızıntının gerçekleştiği tarih (bulaşma tarihi). (sızıntı olayları)"
        },
        "stealerFamily": {
          "type": "string",
          "description": "Hırsız yazılım ailesi. (sızıntı olayları)"
        },
        "groupId": {
          "type": "string",
          "description": "İlgili koruma kaynağı grubu."
        },
        "scanId": {
          "type": "string",
          "description": "Tarama kimliği — `GET /v1/scans/{scanId}`. (tarama olayları)"
        },
        "completedAt": {
          "type": "string",
          "description": "Taramanın bittiği zaman. (tarama olayları)"
        },
        "stats": {
          "type": "object",
          "description": "Tarama sonuç sayıları; başarısız taramada sıfır. (tarama olayları)",
          "properties": {
            "totalMatches": {
              "type": "number",
              "description": "Toplam eşleşme."
            },
            "newMatches": {
              "type": "number",
              "description": "Bu taramada ilk kez bulunan eşleşme."
            },
            "severities": {
              "type": "object",
              "description": "Önem düzeyine göre eşleşme sayıları.",
              "properties": {
                "critical": {
                  "type": "number",
                  "description": "Kritik."
                },
                "high": {
                  "type": "number",
                  "description": "Yüksek."
                },
                "medium": {
                  "type": "number",
                  "description": "Orta."
                },
                "low": {
                  "type": "number",
                  "description": "Düşük."
                },
                "info": {
                  "type": "number",
                  "description": "Bilgi."
                },
                "unknown": {
                  "type": "number",
                  "description": "Bilinmeyen."
                }
              }
            }
          }
        },
        "message": {
          "type": "string",
          "description": "Açıklama. (yalnız `webhook.test`)"
        },
        "targetId": {
          "type": "string",
          "description": "Yeni bulgu çıkan izleme hedefi — `GET /v1/hunter/findings?targetId=…`. (`hunter.finding.created`)"
        },
        "targetKind": {
          "type": "string",
          "description": "Hedef türü (ör. `domain`, `email`). (`hunter.finding.created`)"
        },
        "newFindings": {
          "type": "number",
          "description": "Bu taramada eklenen bulgu sayısı; `data.severity` en yüksek önemdir. (`hunter.finding.created`)"
        }
      }
    }
  }
}