Qoruma resursu yarat

İzləniləcək yeni varlıq əlavə edir. Varlıq növünə görə taranır və izlənilir.

POST/v1/protection-resources

POSTQoruma resursu yarat

curl -X POST "https://api.darkradar.com/api/public/v1/protection-resources" \
  -H "x-api-key: $DARKRADAR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"groupId":"64b1f0c2a9e4d21f8c3b9a10","resourceType":"domain","targetValue":"darkradar.com","description":"Ana alan adı"}'

Cavab

Yaradıldı

{
  "success": true,
  "message": "OK",
  "data": {
    "resource": {
      "_id": "507f1f77bcf86cd799439011",
      "firm": "507f1f77bcf86cd799439012",
      "resourceType": "domain",
      "targetValue": "newdomain.com",
      "label": "Secondary Domain",
      "isActive": true,
      "createdAt": "2024-01-15T10:30:00.000Z",
      "updatedAt": "2024-01-15T10:30:00.000Z"
    }
  },
  "meta": {
    "timestamp": "2024-02-01T10:30:45.123Z",
    "requestId": "a1b2c3d4-e5f6-7890-abcd-ef1234567890",
    "responseTime": 78
  }
}

Giriş icazəsi

Əhatəprotection-resources:write

Plan hüququapi_access

Sorğu gövdəsi

Sahələr	Dəyərlər
`groupId` · string · məcburi	Resursun bağlı olduğu qrup (`GET /v1/protection-resources/groups`)
`resourceType` · string · məcburi	Resurs növü · Dəyərlər: domain, ip, hwid, email, username, application
`targetValue` · string · məcburi	İzləniləcək dəyər
`description` · string · istəyə bağlı	Təsvir
`isActive` · boolean · istəyə bağlı	İzləmə aktivdirmi
`thirdPartyInclude` · boolean · istəyə bağlı	Üçüncü tərəf sızmaları da əhatə olunsunmu
`matchMode` · string · istəyə bağlı	Uyğunluq rejimi · Dəyərlər: machine, credential
`metadata` · object · istəyə bağlı	Sərbəst əlavə məlumat

Cavablar

201Yaradıldı

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

Qoruma resursuCavab modeli

Cavab limitləri

Sürət limiti15 dəqiqədə 500 sorğu · IP başına

curl -X POST "https://api.darkradar.com/api/public/v1/protection-resources" \ -H "x-api-key: $DARKRADAR_API_KEY" \ -H "Content-Type: application/json" \ -d '{"groupId":"64b1f0c2a9e4d21f8c3b9a10","resourceType":"domain","targetValue":"darkradar.com","description":"Ana alan adı"}'

{ "success": true, "message": "OK", "data": { "resource": { "_id": "507f1f77bcf86cd799439011", "firm": "507f1f77bcf86cd799439012", "resourceType": "domain", "targetValue": "newdomain.com", "label": "Secondary Domain", "isActive": true, "createdAt": "2024-01-15T10:30:00.000Z", "updatedAt": "2024-01-15T10:30:00.000Z" } }, "meta": { "timestamp": "2024-02-01T10:30:45.123Z", "requestId": "a1b2c3d4-e5f6-7890-abcd-ef1234567890", "responseTime": 78 } }