API belgeleri

Teslim geçmişi

Son teslimler, en yeni önce (en çok 100, 30 gün saklanır): olay kimliği ve türü, durum (`delivered`, `retrying`, `failed`), alıcının HTTP durumu, toplam deneme, süre ve bekleyen teslimde bir sonraki deneme zamanı. Gövde ve adres geçmişte tutulmaz. Geçici hatada (`429`, `5xx`, ağ) teslim hemen 3 kez denenir, olmazsa 1 dk, 5 dk, 30 dk, 2 sa ve 6 sa sonra yeniden denenir (her seferinde yeni zaman damgasıyla imzalı, aynı `id` ile); `4xx` yeniden denenmez.

GET/v1/webhooks/{groupId}/deliveries
GETTeslim geçmişi
curl -X GET "https://api.darkradar.com/api/public/v1/webhooks/64b1f0c2a9e4d21f8c3b9a10/deliveries" \
  -H "x-api-key: $DARKRADAR_API_KEY"
Yanıt

Başarılı

{
  "success": true,
  "message": "OK",
  "data": {
    "deliveries": [
      {
        "id": "evt_12736aaa38942ca6e77d5c23",
        "type": "scan.finished",
        "state": "delivered",
        "ok": true,
        "status": 204,
        "attempts": 1,
        "durationMs": 42,
        "reason": null,
        "at": "2026-09-19T15:33:20.772Z",
        "nextAttemptAt": null
      },
      {
        "id": "evt_4cac069ffa3ac435ae861034",
        "type": "leak.created",
        "state": "retrying",
        "ok": false,
        "status": 503,
        "attempts": 3,
        "durationMs": 5112,
        "reason": "http_503",
        "at": "2026-09-19T15:31:02.108Z",
        "nextAttemptAt": "2026-09-19T15:32:02.108Z"
      }
    ]
  }
}

Yetki

Kapsamwebhooks:read
Plan yetkisiapi_access

Yol parametreleri

AlanlarDeğerler
groupId · string · zorunluKoruma kaynağı grubunun kimliği (24 karakter); GET /v1/protection-resources/groups · Örnek: 64b1f0c2a9e4d21f8c3b9a10

Sorgu parametreleri

AlanlarDeğerler
limit · integer · isteğe bağlıSayfa başına kayıt (en çok 100) · Örnek: 100

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

Yanıt sınırları

Sayfa boyutulimit · varsayılan 100 · en çok 100
Hız sınırı15 dakikada 500 istek · IP başına

Bu sayfa işinize yaradı mı?