API belgeleri

Sızıntı olaylarını listele

Sızıntı olaylarını süzme ve sıralama seçenekleriyle sayfa sayfa listeler. Bir olay; alan adı, kimlik bilgisi ya da kaynak gibi ortak özelliği olan sızıntıları bir araya getirir.

GET/v1/leak-events
GETSızıntı olaylarını listele
curl -X GET "https://api.darkradar.com/api/public/v1/leak-events" \
  -H "x-api-key: $DARKRADAR_API_KEY"
Yanıt

Başarılı · Gerçek yanıttan, değerler anonimleştirildi

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

Yetki

Kapsamleak-events:read
Plan yetkisiintel_customer

Sorgu parametreleri

AlanlarDeğerler
page · integer · isteğe bağlıSayfa numarası (1’den başlar) · Örnek: 1
limit · integer · isteğe bağlıSayfa başına kayıt (en çok 100) · Örnek: 50
leakType · string · isteğe bağlıSızan değerin türüne göre süz · Değerler: domain, email, username, ip, hwid, application · Örnek: email
type · string · isteğe bağlıOlay türüne göre süz · customer yalnız 360 ile; 360 yoksa boş liste döner. · Değerler: employee, third-party, customer · Örnek: employee
search · string · isteğe bağlıOlay alanlarında metin araması · Örnek: admin
domain · string · isteğe bağlıAlan adına göre süz · Örnek: example.com
subdomain · string · isteğe bağlıAlt alan adına göre süz · Örnek: app.example.com
status · string · isteğe bağlıDuruma göre süz · Değerler: open, ack, solved, closed, re-open, blocked · Örnek: open
sortBy · string · isteğe bağlıSıralama alanı ve yönü · Olay tarihine göre: date-desc en yeni önce (varsayılan), date-asc en eski önce. Tanınmayan değer hata vermez, varsayılana düşer. · Değerler: date-desc, date-asc · Örnek: date-desc
actionTaken · boolean · isteğe bağlıİşlem yapılmış olaylar (true) ya da yapılmamış olanlar (false) · Örnek: false
startDate · string · isteğe bağlıBu tarihten sonra (ISO 8601) · Olay tarihine (eventDate) uygulanır. · Örnek: 2026-09-01T00:00:00Z
endDate · string · isteğe bağlıBu tarihten önce (ISO 8601) · Olay tarihine (eventDate) uygulanır. · Örnek: 2026-09-30T23:59:59Z
groupId · string · isteğe bağlıKaynak grubuna göre süz · Örnek: 507f1f77bcf86cd799439011
groupBy · string · isteğe bağlıGruplama alanı · Örnek: domain
cursor · string · isteğe bağlıSonraki sayfanın imleci (yanıttaki değer olduğu gibi gönderilir); yalnız tarihe göre sıralamada

Yanıtlar

200Başarılı
400İstek geçersiz (bozuk kimlik, eksik ya da hatalı alan)
401Anahtar yok, geçersiz, süresi dolmuş ya da iptal edilmiş
403Kapsam yetersiz, planda API erişimi yok ya da ürün açık değil
404Kayıt yok ya da bu anahtarın firmasına ait değil
408İstek azami yanıt süresini aştı
429Hız sınırı aşıldı; bir dakika sonra tekrar deneyin

Yanıt sınırları

Sayfa boyutulimit · varsayılan 50 · en çok 100
Hız sınırı15 dakikada 500 istek · IP başına

Bu sayfa işinize yaradı mı?