Taramaları siyahıla

Qeydiyyatlı domenləriniz üzərində aparılan təhlükəsizlik taramalarını səhifə-səhifə siyahılayır.

GET/v1/scans

GETTaramaları siyahıla

curl -X GET "https://api.darkradar.com/api/public/v1/scans" \
  -H "x-api-key: $DARKRADAR_API_KEY"

Cavab

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

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

Giriş icazəsi

Əhatəscans:read

Plan hüququapi_access

Sorğu parametrləri

Sahələr	Də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`
`status` · string · istəyə bağlı	Statusa görə süz · Nümunə: `completed`
`scanType` · string · istəyə bağlı	Tarama növünə görə süz · Nümunə: `manual`
`protectionResourceId` · string · istəyə bağlı	Qoruma resursuna görə süz · Nümunə: `507f1f77bcf86cd799439011`
`sortBy` · string · istəyə bağlı	Sıralama sahəsi və istiqaməti · Nümunə: `createdAt`
`cursor` · string · istəyə bağlı	Növbəti səhifənin kursoru (cavabdakı dəyər olduğu kimi göndərilir)

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

TaramaCavab modeli

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

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