웹훅 엔드포인트로 이벤트 재전송
POST /v1/webhook-endpoints/{endpoint_id}:replay · 권한 webhook-endpoints:write · 모든 요금제
최근 30일 이내에 해당하는 [from, to) 범위의 이벤트를 다시 큐에 넣습니다. 예를 들어 엔드포인트가 비활성화되어 있던 기간의 이벤트를 재전송할 때 사용합니다. types로 범위를 좁히지 않으면 엔드포인트의 이벤트 유형만 전송됩니다. 재전송된 각 전송은 이벤트의 webhook-id를 유지하므로, webhook-id로 중복을 제거하는 수신자는 각 이벤트를 한 번만 처리합니다. 전송의 replay_no는 1씩 증가합니다.
요청
| 필드 | 유형 | 필수 | 설명 |
|---|---|---|---|
endpoint_id |
path | 예 | 웹훅 엔드포인트 ID(whe_…). |
from |
date-time | 예 | 범위의 시작(포함), 최근 30일 이내여야 합니다. |
to |
date-time | 예 | 범위의 끝(제외), from 이후여야 합니다. |
types |
string[] | 아니요 | 재전송할 이벤트 유형. 비어 있거나 없으면 엔드포인트의 유형을 사용합니다. |
Idempotency-Key |
header | 아니요 | 같은 키로 반복된 요청에 대해 응답을 재생하며, 다시 큐에 넣지 않습니다. |
{
"from": "2026-10-20T00:00:00Z",
"to": "2026-10-21T00:00:00Z",
"types": ["user.created"]
}
응답
200 OK와 큐에 추가된 전송 수입니다.
{
"enqueued": 42
}
오류
| HTTP | code | 조건 |
|---|---|---|
| 400 | unknown_field |
본문에 위에 나열되지 않은 필드가 있습니다. |
| 404 | not_found |
이 환경에 해당 엔드포인트가 없습니다. |
| 415 | unsupported_media_type |
본문이 없거나 application/json이 아닙니다. |
| 422 | validation_failed |
/from required, /to required, 또는 범위 규칙 위반: to가 from 이후가 아니거나 30일보다 오래되었습니다. |
| 401 | unauthenticated |
자격 증명이 없거나 잘못되었거나 취소되었습니다. |
| 403 | insufficient_permissions |
자격 증명에 webhook-endpoints:write 권한이 없습니다. |
| 503 | service_unavailable |
이 리전에서는 아직 재전송을 사용할 수 없거나 웹훅 관리 기능을 일시적으로 사용할 수 없습니다. Retry-After 이후에 다시 시도하십시오. |
예제
curl -X POST https://api.eu.keenauth.com/v1/webhook-endpoints/whe_01k8a3m5q7t9v1w3x5y7z9b2c4:replay \
-H "Authorization: Bearer $KEENAUTH_SECRET_KEY" \
-H "Content-Type: application/json" \
-H "Idempotency-Key: 7a1c3e5f-9b2d-4f6a-8c0e-2b4d6f8a0c2e" \
-d '{"from":"2026-10-20T00:00:00Z","to":"2026-10-21T00:00:00Z"}'
CLI(본문은 표준 입력 또는 파일(--data @replay.json)에서 가져옵니다):
echo '{"from":"2026-10-20T00:00:00Z","to":"2026-10-21T00:00:00Z"}' | keenauth webhook-endpoints replay whe_01k8a3m5q7t9v1w3x5y7z9b2c4 --data -