sayren Docs
웹훅

웹훅 전송 기록

최근 30일의 전송 기록. 최신 적재순. 이벤트 하나가 한 기록이며 재시도는 같은 기록의 `attemptCount`로 누적된다. 수동 재전송은 같은 `eventId`를 가진 새 기록(`redeliveryOf`=원본)으로 생긴다.

GET
/v1/webhooks/{webhookId}/deliveries

최근 30일의 전송 기록. 최신 적재순. 이벤트 하나가 한 기록이며 재시도는 같은 기록의 attemptCount로 누적된다. 수동 재전송은 같은 eventId를 가진 새 기록(redeliveryOf=원본)으로 생긴다.

Authorization

bearer
AuthorizationBearer <token>

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

In: header

Path Parameters

webhookId*string

Query Parameters

status?string

전송 상태 필터. 생략하면 전체

Value in

  • "PENDING"
  • "PENDING_RETRY"
  • "SUCCESS"
  • "FAILED"
limit?integer

최대 건수 (1~100, 기본 50). 최신 적재순으로 반환하며 보관 기간은 30일이다

Range1 <= value <= 100

Response Body

application/json

curl -X GET "https://example.com/v1/webhooks/string/deliveries"
{  "meta": {    "status": 200,    "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

`SUSPENDED` 구독을 `ACTIVE`로 되돌리고 연속 실패 기록을 초기화한다. 이미 `ACTIVE`면 그대로 반환한다(멱등). 정지 중에 발생한 이벤트는 적재되지 않았고 정지 시 대기 중이던 전송은 `FAILED`로 종료됐으므로, 놓친 전송은 실패 건 재전송(`POST /v1/webhooks/{webhookId}/deliveries/redeliver-failed`)으로 복구한다.

실패 건 일괄 재전송 POST

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