sayren Docs
웹훅

웹훅 서명 시크릿 교체

새 시크릿 평문은 이 응답에서만 노출된다. 이전 시크릿은 `oldSecretExpiresAt`(24시간 뒤)까지 병행 유효하며, 그동안 발송되는 요청의 `Sayren-Signature`에는 두 시크릿의 서명이 모두(새 시크릿 먼저) 실린다. 유예 중 다시 교체하면 가장 오래된 시크릿은 즉시 폐기된다.

POST
/v1/webhooks/{webhookId}/rotate-secret

새 시크릿 평문은 이 응답에서만 노출된다. 이전 시크릿은 oldSecretExpiresAt(24시간 뒤)까지 병행 유효하며, 그동안 발송되는 요청의 Sayren-Signature에는 두 시크릿의 서명이 모두(새 시크릿 먼저) 실린다. 유예 중 다시 교체하면 가장 오래된 시크릿은 즉시 폐기된다.

Authorization

accessToken
headerAuthorizationBearer <token>

Sayren 계정 토큰(로그인 토큰 또는 개인 액세스 토큰, RFC 9068 JWT)

Path Parameters

webhookId*string

Header Parameters

X-Store-Id*string

대상 상점 id. 토큰의 상점 범위 밖이면 403 STORE_NOT_GRANTED, 없으면 400 STORE_ID_REQUIRED다

Response Body

성공

application/json
  1. response
meta*
data*
error*|null
curl -X POST 'https://api.sayren.io/v1/webhooks/string/rotate-secret' \  -H 'X-Store-Id: string'
{  "meta": {    "status": 200,    "code": "OK",    "message": "OK",    "isSuccess": true  },  "data": {    "secret": "string",    "oldSecretExpiresAt": "string"  },  "error": null}