Bildirim adresini ayarla

Grubun bildirim adresini oluşturur ya da günceller. İlk oluşturmada yanıt `201` ve `signingSecret` içerir — sır yalnız bu yanıtta gösterilir, saklayın. Güncelleme `200` döner ve sırrı değiştirmez; verilmeyen alanlar olduğu gibi kalır.

PUT/v1/webhooks/{groupId}

PUTBildirim adresini ayarla

curl -X PUT "https://api.darkradar.com/api/public/v1/webhooks/64b1f0c2a9e4d21f8c3b9a10" \
  -H "x-api-key: $DARKRADAR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"url":"https://darkradar.com/darkradar-webhook","events":["leak.created","scan.failed"],"severities":["critical","high"]}'

Yanıt

Başarılı

{
  "success": true,
  "message": "OK",
  "data": {
    "webhook": {
      "groupId": "64b1f0c2a9e4d21f8c3b9a10",
      "url": "•••• https://darkradar.com/…hook",
      "events": [
        "leak.created",
        "scan.finished",
        "scan.failed"
      ],
      "severities": [
        "critical",
        "high"
      ],
      "isActive": true,
      "lastDelivery": {
        "at": "2026-09-19T15:33:20.772Z",
        "ok": true,
        "type": "scan.finished",
        "reason": null
      },
      "createdAt": "2026-09-19T15:33:20.631Z",
      "updatedAt": "2026-09-19T15:33:20.673Z"
    }
  }
}

Yetki

Kapsamwebhooks:write

Plan yetkisiapi_access

Yol parametreleri

Alanlar	Değerler
`groupId` · string · zorunlu	Koruma kaynağı grubunun kimliği (24 karakter); `GET /v1/protection-resources/groups` · Örnek: `64b1f0c2a9e4d21f8c3b9a10`

İstek gövdesi

Alanlar	Değerler
`url` · string · isteğe bağlı	Teslim adresi: `https` ve herkese açık bir adres (iç ağ, localhost, bulut meta veri adresi reddedilir). Oluştururken zorunlu.
`events` · string[] · isteğe bağlı	Abone olunan olaylar. Oluştururken verilmezse `leak.created`; güncellemede verilmezse değişmez. · Değerler: leak.created, scan.finished, scan.failed, hunter.finding.created
`severities` · string[] · isteğe bağlı	Sızıntı olaylarında önem süzgeci. Oluştururken verilmezse hepsi; güncellemede verilmezse değişmez. · Değerler: critical, high, medium, low, info, unknown
`isActive` · boolean · isteğe bağlı	Teslim açık mı (kapalıyken olay gönderilmez).

Yanıtlar

200Başarılı

201Oluşturuldu

400Adres kabul edilmedi (https değil, iç ağ / localhost / bulut meta veri adresi) ya da bilinmeyen olay/önem

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

Bildirim adresiYanı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/webhooks/64b1f0c2a9e4d21f8c3b9a10" \ -H "x-api-key: $DARKRADAR_API_KEY" \ -H "Content-Type: application/json" \ -d '{"url":"https://darkradar.com/darkradar-webhook","events":["leak.created","scan.failed"],"severities":["critical","high"]}'

{ "success": true, "message": "OK", "data": { "webhook": { "groupId": "64b1f0c2a9e4d21f8c3b9a10", "url": "•••• https://darkradar.com/…hook", "events": [ "leak.created", "scan.finished", "scan.failed" ], "severities": [ "critical", "high" ], "isActive": true, "lastDelivery": { "at": "2026-09-19T15:33:20.772Z", "ok": true, "type": "scan.finished", "reason": null }, "createdAt": "2026-09-19T15:33:20.631Z", "updatedAt": "2026-09-19T15:33:20.673Z" } } }