웹훅
웹훅 구독 수정
URL·이벤트 타입을 바꾼다. `SUSPENDED` 구독은 수정하면 `ACTIVE`로 돌아가고 연속 실패 기록이 초기화된다. 정지 중 종료된 전송은 되살아나지 않으므로 필요하면 실패 건 재전송을 요청한다. URL 규칙은 등록과 같다.
PUT
URL·이벤트 타입을 바꾼다. SUSPENDED 구독은 수정하면 ACTIVE로 돌아가고 연속 실패 기록이 초기화된다. 정지 중 종료된 전송은 되살아나지 않으므로 필요하면 실패 건 재전송을 요청한다. URL 규칙은 등록과 같다.
accessTokenheader
AuthorizationBearer <token>Sayren 계정 토큰(로그인 토큰 또는 개인 액세스 토큰, RFC 9068 JWT)
webhookId*stringX-Store-Id*string대상 상점 id. 토큰의 상점 범위 밖이면 403 STORE_NOT_GRANTED, 없으면 400 STORE_ID_REQUIRED다
application/json- body
url*stringMatch
^https:\/\/.*Format
starts_witheventTypes*array<>Items
1 <= items성공
application/json- response
meta*data*error*|nullcurl -X PUT 'https://api.sayren.io/v1/webhooks/string' \ -H 'X-Store-Id: string' \ -H 'Content-Type: application/json' \ -d '{ "url": "string", "eventTypes": [ "ORDER.PAID" ]}'{ "meta": { "status": 200, "code": "OK", "message": "OK", "isSuccess": true }, "data": { "webhookId": "string", "url": "http://example.com", "eventTypes": [ "ORDER.PAID" ], "status": "ACTIVE", "secretPrefix": "string", "suspendedAt": "string", "createdAt": "string" }, "error": null}