Koruma kaynağını güncelle

Bir koruma kaynağını günceller. Etiketi, üst veriyi ve diğer özellikleri değiştirebilirsiniz.

PUT/v1/protection-resources/{id}

PUTKoruma kaynağını güncelle

curl -X PUT "https://api.darkradar.com/api/public/v1/protection-resources/507f1f77bcf86cd799439011" \
  -H "x-api-key: $DARKRADAR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"description":"Kurumsal alan adı"}'

Yanıt

Başarılı

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

Yetki

Kapsamprotection-resources:write

Plan yetkisiapi_access

Yol parametreleri

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

İstek gövdesi

Alanlar	Değerler
`groupId` · string · isteğe bağlı	Kaynağı başka bir gruba taşı
`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

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

Koruma kaynağıYanıt modeli

Yanıt sınırları

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

curl -X PUT "https://api.darkradar.com/api/public/v1/protection-resources/507f1f77bcf86cd799439011" \ -H "x-api-key: $DARKRADAR_API_KEY" \ -H "Content-Type: application/json" \ -d '{"description":"Kurumsal alan adı"}'

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