Creative Webhooks
Webhook 署名シークレットをローテーション
新しい whsec_ 署名シークレットを発行し、全文を一度だけ返します。旧シークレットは 24 時間後の rotation.previous_valid_until まで併用され、その間の配信は新旧両方で署名します。期限までに受信側を新しいシークレットへ切り替えます。期限内に再度ローテーションすると、直前のシークレットだけが併用対象になります。
POST
/v1/creative/webhooks/signing-secret/rotate
curl --request POST 'https://api.orchestor.io/v1/creative/webhooks/signing-secret/rotate' \ --header "Authorization: Bearer $ORCHESTOR_API_KEY"{ "data": { "scope": "workspace", "version": 1, "fingerprint": "sha256:0123456789abcdef", "secret": "<WEBHOOK_SIGNING_SECRET>", "rotation": null }}Authorizations
Authentication details
bearer
Response
application/json
署名検証用シークレットと世代情報。secret はサーバー側で保管し、ローテーション時は rotation の旧世代有効期限を確認します。
Headers
{ "data": { "scope": "workspace", "version": 1, "fingerprint": "sha256:0123456789abcdef", "secret": "<WEBHOOK_SIGNING_SECRET>", "rotation": null }}