API sənədləri

Sızma hadisələrini siyahıla

Sızma hadisələrini süzgəc və sıralama seçimləri ilə səhifə-səhifə siyahılayır. Hadisə domen, kimlik məlumatı və ya mənbə kimi ortaq xüsusiyyəti olan sızmaları bir yerə toplayır.

GET/v1/leak-events
GETSızma hadisələrini siyahıla
curl -X GET "https://api.darkradar.com/api/public/v1/leak-events" \
  -H "x-api-key: $DARKRADAR_API_KEY"
Cavab

Uğurlu · Real cavabdan, dəyərlər anonimləşdirilib

{
  "success": true,
  "message": "OK",
  "data": {
    "events": [
      {
        "_id": "64b1f0c2a9e4d21f8c3b9005",
        "firm": "64b1f0c2a9e4d21f8c3b9004",
        "protectionResourceGroupId": null,
        "eventId": "64b1f0c2a9e4d21f8c3b9005",
        "leakType": "email",
        "type": "employee",
        "severity": "high",
        "mainValue": null,
        "stealerFamily": "GENERIC STEALER",
        "stealerFamilies": [],
        "eventDate": "2026-09-18T14:54:04.834Z",
        "status": "open",
        "actionTaken": false,
        "actions": [],
        "metadata": {},
        "leakMetadata": {
          "username": null,
          "password": null,
          "domain": null,
          "usernameDomain": null
        },
        "relationCount": 0
      }
    ]
  }
}

Giriş icazəsi

Əhatəleak-events:read
Plan hüququintel_customer

Sorğu parametrləri

SahələrDəyərlər
page · integer · istəyə bağlıSəhifə nömrəsi (1-dən başlayır) · Nümunə: 1
limit · integer · istəyə bağlıSəhifə başına qeyd (ən çox 100) · Nümunə: 50
leakType · string · istəyə bağlıSızan dəyərin növünə görə süz · Dəyərlər: domain, email, username, ip, hwid, application · Nümunə: email
type · string · istəyə bağlıHadisə növünə görə süz · customer yalnız 360 ilə; 360 yoxdursa boş siyahı qaytarılır. · Dəyərlər: employee, third-party, customer · Nümunə: employee
search · string · istəyə bağlıHadisə sahələrində mətn axtarışı · Nümunə: admin
domain · string · istəyə bağlıDomenə görə süz · Nümunə: example.com
subdomain · string · istəyə bağlıAlt domenə görə süz · Nümunə: app.example.com
status · string · istəyə bağlıStatusa görə süz · Dəyərlər: open, ack, solved, closed, re-open, blocked · Nümunə: open
sortBy · string · istəyə bağlıSıralama sahəsi və istiqaməti · Hadisə tarixinə görə: date-desc ən yeni əvvəl (ilkin), date-asc ən köhnə əvvəl. Tanınmayan dəyər xəta vermir, ilkinə düşür. · Dəyərlər: date-desc, date-asc · Nümunə: date-desc
actionTaken · boolean · istəyə bağlıƏməliyyat aparılmış hadisələr (true) və ya aparılmamışlar (false) · Nümunə: false
startDate · string · istəyə bağlıBu tarixdən sonra (ISO 8601) · Hadisə tarixinə (eventDate) tətbiq olunur. · Nümunə: 2026-09-01T00:00:00Z
endDate · string · istəyə bağlıBu tarixdən əvvəl (ISO 8601) · Hadisə tarixinə (eventDate) tətbiq olunur. · Nümunə: 2026-09-30T23:59:59Z
groupId · string · istəyə bağlıResurs qrupuna görə süz · Nümunə: 507f1f77bcf86cd799439011
groupBy · string · istəyə bağlıQruplaşdırma sahəsi · Nümunə: domain
cursor · string · istəyə bağlıNövbəti səhifənin kursoru (cavabdakı dəyər olduğu kimi göndərilir); yalnız tarixə görə sıralamada

Cavablar

200Uğurlu
400Sorğu etibarsızdır (pozuq kimlik, çatışmayan və ya səhv sahə)
401Açar yoxdur, etibarsızdır, müddəti bitib və ya ləğv edilib
403Əhatə kifayət etmir, planda API girişi yoxdur və ya məhsul açıq deyil
404Qeyd yoxdur və ya bu açarın şirkətinə aid deyil
408Sorğu maksimum cavab müddətini aşdı
429Sürət həddi aşıldı; bir dəqiqə sonra yenidən yoxlayın

Cavab limitləri

Səhifə ölçüsülimit · susmaya görə 50 · maksimum 100
Sürət limiti15 dəqiqədə 500 sorğu · IP başına

Bu səhifə işinizə yaradı?