Taramaları listele

Kayıtlı alan adlarınız üzerinde yapılan güvenlik taramalarını sayfa sayfa listeler.

GET/v1/scans

GETTaramaları listele

curl -X GET "https://api.darkradar.com/api/public/v1/scans" \
  -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": {
    "scans": [
      {
        "stats": {
          "severities": {
            "critical": 0,
            "high": 0,
            "medium": 0,
            "low": 0,
            "unknown": 0
          },
          "types": {
            "employee": 0,
            "customer": 0
          },
          "resourceTypeBreakdown": {
            "domain": 0,
            "email": 0,
            "ip": 0,
            "hwid": 0,
            "username": 0,
            "application": 0
          },
          "totalItemsChecked": 0,
          "totalResourcesScanned": 0,
          "totalMatches": 0,
          "newMatches": 0,
          "credentialsFound": 0,
          "machinesFound": 0
        },
        "error": {
          "message": null,
          "code": null
        },
        "_id": "64b1f0c2a9e4d21f8c3b9006",
        "firm": "64b1f0c2a9e4d21f8c3b9004",
        "protectionResourceGroupId": "64b1f0c2a9e4d21f8c3b9007",
        "scanType": "manual",
        "status": "pending",
        "startedAt": "2026-09-18T14:34:26.029Z",
        "completedAt": null,
        "durationMs": null,
        "resourceResults": [],
        "createdAt": "2026-09-18T14:34:26.031Z",
        "updatedAt": "2026-09-18T14:34:26.031Z"
      }
    ]
  },
  "pagination": {
    "total": 2,
    "page": 1,
    "limit": 1,
    "totalPages": 2
  }
}

Yetki

Kapsamscans:read

Plan yetkisiapi_access

Sorgu parametreleri

Alanlar	Değ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`
`status` · string · isteğe bağlı	Duruma göre süz · Örnek: `completed`
`scanType` · string · isteğe bağlı	Tarama türüne göre süz · Örnek: `manual`
`protectionResourceId` · string · isteğe bağlı	Koruma kaynağına göre süz · Örnek: `507f1f77bcf86cd799439011`
`sortBy` · string · isteğe bağlı	Sıralama alanı ve yönü · Örnek: `createdAt`
`cursor` · string · isteğe bağlı	Sonraki sayfanın imleci (yanıttaki değer olduğu gibi gönderilir)

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

TaramaYanıt modeli

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

{ "success": true, "message": "OK", "data": { "scans": [ { "stats": { "severities": { "critical": 0, "high": 0, "medium": 0, "low": 0, "unknown": 0 }, "types": { "employee": 0, "customer": 0 }, "resourceTypeBreakdown": { "domain": 0, "email": 0, "ip": 0, "hwid": 0, "username": 0, "application": 0 }, "totalItemsChecked": 0, "totalResourcesScanned": 0, "totalMatches": 0, "newMatches": 0, "credentialsFound": 0, "machinesFound": 0 }, "error": { "message": null, "code": null }, "_id": "64b1f0c2a9e4d21f8c3b9006", "firm": "64b1f0c2a9e4d21f8c3b9004", "protectionResourceGroupId": "64b1f0c2a9e4d21f8c3b9007", "scanType": "manual", "status": "pending", "startedAt": "2026-09-18T14:34:26.029Z", "completedAt": null, "durationMs": null, "resourceResults": [], "createdAt": "2026-09-18T14:34:26.031Z", "updatedAt": "2026-09-18T14:34:26.031Z" } ] }, "pagination": { "total": 2, "page": 1, "limit": 1, "totalPages": 2 } }