验签与重试
保存签名密钥
创建 Webhook 配置时,平台会返回该配置的签名密钥。请在创建后立即将密钥保存到密钥管理服务或服务端环境变量中,不要写入代码、日志或前端页面。后续查询仅返回脱敏后的密钥,无法用于验签。
签名规则
平台使用 Webhook 配置的密钥,以 HTTP 原始请求体字节作为消息计算 HMAC-SHA256,再将摘要转换为 Base64 编码,并通过 x-wk-signature 请求头发送:
x-wk-signature = Base64(HMAC-SHA256(webhook_secret, raw_request_body))
接收端必须用相同方式计算签名,并与 x-wk-signature 比较。不要先解析再重新序列化 JSON;即使字段和值相同,空格、换行或字段顺序变化也会产生不同的签名。