Envanter öğesinin ayrıntılarını getir

Bir envanter öğesinin ayrıntılarını döndürür: üst veri, ilişkiler ve işlenme durumu.

GET/v1/inventory/{id}

GETEnvanter öğesinin ayrıntılarını getir

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

Yanıt

Başarılı

{
  "success": true,
  "message": "OK",
  "data": {
    "item": {
      "_id": "507f1f77bcf86cd799439011",
      "firm": "507f1f77bcf86cd799439010",
      "fileName": "DARKRADAR#69b88E9U91360.zip",
      "fileSize": 534773,
      "mimeType": "application/zip",
      "hasFile": true,
      "unlockedAt": "2024-01-15T10:00:00Z",
      "protectionResourceId": "507f1f77bcf86cd799439015",
      "protectionResourceGroupId": "507f1f77bcf86cd799439016",
      "eventId": {
        "_id": "507f1f77bcf86cd799439012",
        "type": "employee",
        "leakType": "domain",
        "severity": "high",
        "status": "open",
        "eventDate": "2024-01-14T15:30:00Z"
      },
      "relationId": {
        "_id": "507f1f77bcf86cd799439013",
        "machineId": {
          "_id": "507f1f77bcf86cd799439014",
          "computerName": "DESKTOP-***",
          "countryCode": "TR",
          "operatingSystem": "Windows 11"
        },
        "stealerFamilyId": {
          "_id": "507f1f77bcf86cd799439017",
          "name": "Lumma"
        }
      },
      "metadata": {
        "stealerFamily": "Lumma",
        "ipAddress": "203.0.113.10",
        "countryCode": "TR"
      },
      "createdAt": "2024-01-15T10:00:00Z",
      "updatedAt": "2024-01-15T10:00:00Z"
    }
  },
  "meta": {
    "timestamp": "2024-02-01T10:30:45.123Z",
    "requestId": "a1b2c3d4-e5f6-7890-abcd-ef1234567890",
    "responseTime": 34
  }
}

Yetki

Kapsaminventory:read

Plan yetkisiapi_access

Yol parametreleri

Alanlar	Değerler
`id` · string · zorunlu	Kaydın kimliği (24 karakter) · Örnek: `507f1f77bcf86cd799439011`

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

Envanter kaydıYanıt modeli

Yanıt sınırları

Hız sınırı15 dakikada 500 istek · IP başına

{ "success": true, "message": "OK", "data": { "item": { "_id": "507f1f77bcf86cd799439011", "firm": "507f1f77bcf86cd799439010", "fileName": "DARKRADAR#69b88E9U91360.zip", "fileSize": 534773, "mimeType": "application/zip", "hasFile": true, "unlockedAt": "2024-01-15T10:00:00Z", "protectionResourceId": "507f1f77bcf86cd799439015", "protectionResourceGroupId": "507f1f77bcf86cd799439016", "eventId": { "_id": "507f1f77bcf86cd799439012", "type": "employee", "leakType": "domain", "severity": "high", "status": "open", "eventDate": "2024-01-14T15:30:00Z" }, "relationId": { "_id": "507f1f77bcf86cd799439013", "machineId": { "_id": "507f1f77bcf86cd799439014", "computerName": "DESKTOP-***", "countryCode": "TR", "operatingSystem": "Windows 11" }, "stealerFamilyId": { "_id": "507f1f77bcf86cd799439017", "name": "Lumma" } }, "metadata": { "stealerFamily": "Lumma", "ipAddress": "203.0.113.10", "countryCode": "TR" }, "createdAt": "2024-01-15T10:00:00Z", "updatedAt": "2024-01-15T10:00:00Z" } }, "meta": { "timestamp": "2024-02-01T10:30:45.123Z", "requestId": "a1b2c3d4-e5f6-7890-abcd-ef1234567890", "responseTime": 34 } }