Koruma kaynağı oluştur

İzlenecek yeni bir varlık ekler. Varlık, türüne göre taranır ve izlenir.

POST/v1/protection-resources

POSTKoruma kaynağı oluştur

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ı"}'

Yanıt

Oluşturuldu

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

Yetki

Kapsamprotection-resources:write

Plan yetkisiapi_access

İstek gövdesi

Alanlar	Değerler
`groupId` · string · zorunlu	Kaynağın bağlı olduğu grup (`GET /v1/protection-resources/groups`)
`resourceType` · string · zorunlu	Kaynak türü · Değerler: domain, ip, hwid, email, username, application
`targetValue` · string · zorunlu	İzlenecek değer
`description` · string · isteğe bağlı	Açıklama
`isActive` · boolean · isteğe bağlı	İzleme açık mı
`thirdPartyInclude` · boolean · isteğe bağlı	Üçüncü taraf sızıntıları da kapsansın mı
`matchMode` · string · isteğe bağlı	Eşleşme kipi · Değerler: machine, credential
`metadata` · object · isteğe bağlı	Serbest ek bilgi

Yanıtlar

201Oluşturuldu

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

Koruma kaynağıYanıt modeli

Yanıt sınırları

Hız sınırı15 dakikada 500 istek · 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 } }