Web kancası teslimini yeniden dene

POST /v1/webhook-endpoints/{endpoint_id}/deliveries/{delivery_id}:retry · izin webhook-endpoints:write · bütün planlar

Son 30 gün içindeki succeeded ya da abandoned bir teslimi aynı olayın yeni bir teslimi olarak yeniden kuyruğa alır ve yeni teslimi döndürür. Yeni teslim olayın webhook-id'sini korur, replay_no'su bir fazladır. Hâlâ pending ya da retrying olan teslim takvimle yeniden denenir, elle yeniden denenemez. Gövde isteğe bağlıdır; verilirse boş nesnedir.

İstek

Alan Tür Zorunlu Açıklama
endpoint_id yol evet Web kancası ucu kimliği (whe_…).
delivery_id yol evet Teslim kimliği (whd_…).
Idempotency-Key başlık hayır Aynı anahtarla tekrarlanan istekte yanıtı yeniden oynatır, yeniden kuyruğa almaz.

Yanıt

Yeni teslimle 200 OK.

{
  "id": "whd_01k8a3m9t1w3x5y7z9b2c4d6f8",
  "endpoint_id": "whe_01k8a3m5q7t9v1w3x5y7z9b2c4",
  "event_id": "evt_01k8a3m7s9v1w3x5y7z9b2c4d6",
  "event_seq": 1042,
  "event_type": "user.created",
  "replay_no": 1,
  "status": "pending",
  "attempt_count": 0,
  "next_attempt_at": "2026-10-26T10:00:00Z",
  "last_http_status": null,
  "last_error_class": null,
  "last_latency_ms": null,
  "created_at": "2026-10-26T10:00:00Z",
  "completed_at": null
}

Hatalar

HTTP code Ne zaman
400 unknown_field Gövde boş nesne değil.
404 not_found Bu ortamda böyle bir uç ya da teslim yok.
409 conflict Teslim pending ya da retrying, 30 günden eski ya da uç enabled değil.
401 unauthenticated Kimlik bilgisi yok, geçersiz ya da iptal edilmiş.
403 insufficient_permissions Kimlik bilgisinde webhook-endpoints:write yok.
503 service_unavailable Web kancası yönetimi geçici olarak kullanılamıyor; Retry-After süresinden sonra yeniden deneyin.

Örnek

curl -X POST https://api.eu.keenauth.com/v1/webhook-endpoints/whe_01k8a3m5q7t9v1w3x5y7z9b2c4/deliveries/whd_01k8a3m6r8t0v2w4x6y8z0b3d5:retry \
  -H "Authorization: Bearer $KEENAUTH_SECRET_KEY" \
  -H "Idempotency-Key: 9c3e5a7b-1d4f-4b6a-8e0c-2d4f6a8c0e2b"

CLI: keenauth webhook-endpoints deliveries retry whe_01k8a3m5q7t9v1w3x5y7z9b2c4 whd_01k8a3m6r8t0v2w4x6y8z0b3d5