Tarama tapıntısı

{
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "$id": "https://darkradar.com/docs/schemas/scan-finding.schema.json",
  "title": "Tarama tapıntısı",
  "description": "Bir taramada tapılan sızma hadisəsi.",
  "type": "object",
  "properties": {
    "_id": {
      "type": "string",
      "description": "Qeydin kimliyi (24 simvollu onaltılıq)."
    },
    "scan": {
      "type": "string",
      "description": "Tapıntının aid olduğu taramanın kimliyi."
    },
    "firm": {
      "type": "string",
      "description": "Qeydin aid olduğu şirkətin kimliyi — həmişə API açarınızın şirkəti."
    },
    "leakEvent": {
      "type": "object",
      "description": "Tapılan sızma hadisəsi (sızma hadisəsi sxemi ilə eyni sahələr).",
      "properties": {
        "_id": {
          "type": "string",
          "description": "Hadisənin kimliyi."
        },
        "eventId": {
          "type": "string",
          "description": "Hadisənin kimliyi (mətn)."
        },
        "leakType": {
          "type": "string",
          "description": "Sızmanın nə ilə uyğunlaşdığı: `domain`, `email`, `username`, `ip`, `hwid`, `application`."
        },
        "type": {
          "type": "string",
          "description": "Kimin sızması: `employee` (işçi), `customer` (müştəri — 360), `third_party` (üçüncü tərəf)."
        },
        "severity": {
          "type": "string",
          "description": "Ciddiyyət: `critical`, `high`, `medium`, `low` və ya `unknown`."
        },
        "mainValue": {
          "type": "string",
          "description": "Uyğun gələn dəyər (domen, e-poçt və s.) — göstərmək üçün."
        },
        "eventDate": {
          "type": "string",
          "description": "Sızmanın baş verdiyi tarix (yoluxma tarixi, ISO 8601)."
        },
        "status": {
          "type": "string",
          "description": "Hadisə statusu."
        },
        "actionTaken": {
          "type": "boolean",
          "description": "Hadisə ilə bağlı əməliyyat aparılıbmı."
        },
        "actionType": {
          "type": [
            "string",
            "null"
          ],
          "description": "Son əməliyyatın növü."
        },
        "metadata": {
          "type": "object",
          "description": "Qeydə əlavə olunan məlumat."
        },
        "stealerFamily": {
          "type": "string",
          "description": "Oğurlayıcı proqram ailəsi (məs. `Lumma`, `RedLine`)."
        },
        "stealerFamilies": {
          "type": "array",
          "description": "Qeydlə əlaqəli bütün oğurlayıcı proqram ailələri.",
          "items": {}
        },
        "systemInfo": {
          "type": "object",
          "description": "Yoluxmuş maşının sistem xülasəsi."
        },
        "relationCount": {
          "type": "number",
          "description": "Əlaqə sayı."
        },
        "createdAt": {
          "type": "string",
          "description": "Yaradılma vaxtı (ISO 8601)."
        },
        "updatedAt": {
          "type": "string",
          "description": "Son yenilənmə vaxtı (ISO 8601)."
        },
        "leakMetadata": {
          "type": "object",
          "description": "Sızan kimlik məlumatının xülasəsi (parol yalnız `***`)."
        }
      }
    },
    "isNewlyFound": {
      "type": "boolean",
      "description": "Bu taramada ilk dəfə tapılıbmı."
    },
    "severityAtScan": {
      "type": "string",
      "description": "Tarama anındakı ciddiyyət."
    },
    "leakType": {
      "type": "string",
      "description": "Sızmanın nə ilə uyğunlaşdığı: `domain`, `email`, `username`, `ip`, `hwid`, `application`."
    },
    "createdAt": {
      "type": "string",
      "description": "Yaradılma vaxtı (ISO 8601)."
    },
    "updatedAt": {
      "type": "string",
      "description": "Son yenilənmə vaxtı (ISO 8601)."
    }
  }
}