sayren Docs
웹훅

전송 기록 재전송

`FAILED` 전송 기록 한 건을 재전송 대기열에 올린다. 응답은 새로 적재된 전송 기록이다(같은 `eventId`, `redeliveryOf`=원본). 원본 하나는 한 번만 재전송할 수 있다. 재전송 기록도 실패하면 그 기록을 다시 재전송한다. 전송 결과는 전송 기록 조회로 확인한다.

POST
/v1/webhooks/{webhookId}/deliveries/{deliveryId}/redeliver

FAILED 전송 기록 한 건을 재전송 대기열에 올린다. 응답은 새로 적재된 전송 기록이다(같은 eventId, redeliveryOf=원본). 원본 하나는 한 번만 재전송할 수 있다. 재전송 기록도 실패하면 그 기록을 다시 재전송한다. 전송 결과는 전송 기록 조회로 확인한다.

Authorization

bearer
AuthorizationBearer <token>

userToken(계정 스코프) 또는 storeToken(스토어 스코프)

In: header

Path Parameters

webhookId*string
deliveryId*string

Response Body

application/json

curl -X POST "https://example.com/v1/webhooks/string/deliveries/string/redeliver"
{  "meta": {    "status": 202,    "code": "OK",    "message": "OK",    "isSuccess": true  },  "data": {    "deliveryId": "string",    "eventId": "string",    "eventType": "ORDER.PAID",    "url": "string",    "status": "PENDING",    "responseStatusCode": 0,    "responseTimeMs": 0,    "responseBodyExcerpt": "string",    "errorCode": "TIMEOUT",    "attemptCount": 0,    "createdAt": "string",    "attemptedAt": "string",    "nextAttemptAt": "string",    "redeliveryOf": "string",    "redeliveredAs": "string"  },  "error": null}

실패 건 일괄 재전송 POST

최근 72시간의 `FAILED` 전송 기록 중 아직 재전송되지 않은 건을 모두(최대 500건, 오래된 순) 재전송 대기열에 올린다. 각 건은 같은 `eventId`로 새 전송 기록이 되며 재시도 규칙도 새로 적용된다. 수신 측은 `eventId`로 중복을 제거한다.

웹훅 테스트 이벤트 발송 POST

지정한 이벤트 타입의 샘플 페이로드(이벤트 ID `evt_test_…`)를 실제 발송 형식·서명 그대로 구독 URL에 한 번 보내고 수신 서버의 응답을 동기로 반환한다. 재시도·정지 판정·전송 기록이 없다. 타임아웃은 10초다.