WebHook

部署 SSL 证书到 WebHook API 接口授权配置

WebHook 即我们主动 POST 证书到你配置的 接收证书的地址,你的服务器返回状态码小于 400 表示部署成功,请在15秒内响应请求,否则会产生超时错误。
如果有 IP 限制策略,请将 121.89.214.110 加入白名单。

请求方法 Mehod:POST
请求头 Request Header
z-timestamp: 时间戳(秒)
z-token: 算法 Hex(HmacSha256("{z-timestamp}", "{验证密钥}")),用 验证密钥 计算 时间戳 HmacSha256 摘要的 16 进制格式
Content-Type: 可选 application/json 或 application/x-www-form-urlencoded
请求载荷 Payload:
选择 application/json 编码时
{
  "ssl": "证书申请单名称",
  "task": "自动化任务名称",
  "certificate": "包括证书链的 PEM 格式证书内容",
  "certificateServer": "不包括证书链的证书",
  "certificateChain": "证书链",
  "key": "PEM 格式的私钥内容",
  "notAfter": "证书过期时间 如 2025-12-01 08:02:03"
}
选择 application/x-www-form-urlencoded 编码时
ssl=xxx&task=xxx...

举例 cURL 请求
证书接收地址 https://www.exmaple.com/ssl/receiver
验证密钥 PQtlT8KNRayprpu621X7hICZE84U9LuC
时间戳 1735982969
# application/json 编码
curl --request POST 'https://www.example.com/ssl/receiver' \
--header "z-timestamp: 1735982969" \
--header "z-token: 792c41a4189b8dc00bee53efd63d49c4017751022e50a83515c5cb2fde0aff77" \
--header "Content-Type: application/json; charset=utf-8" \
--data-raw '{
  "ssl": "证书申请单名称",
  "task": "自动化任务名称",
  "certificate": "-----BEGIN CERTIFICATE-----\nMII......\n-----END CERTIFICATE-----",
  "certificateServer": "-----BEGIN CERTIFICATE-----\nMII......\n-----END CERTIFICATE-----",
  "certificateChain": "-----BEGIN CERTIFICATE-----\nMII......\n-----END CERTIFICATE-----",
  "key": "-----BEGIN RSA PRIVATE KEY-----\nMII......\n-----END RSA PRIVATE KEY-----",
  "notAfter": "2025-12-01 08:12:34"
}'

# application/x-www-form-urlencoded 编码
curl --request POST 'https://www.example.com/ssl/receiver' \
--header "z-timestamp: 1735982969" \
--header "z-token: 792c41a4189b8dc00bee53efd63d49c4017751022e50a83515c5cb2fde0aff77" \
--header "Content-Type: application/x-www-form-urlencoded; charset=utf-8" \
--data-urlencode "ssl=证书申请单名称" \
--data-urlencode "task=自动化任务名称" \
--data-urlencode "certificate=-----BEGIN CERTIFICATE-----
MII......
-----END CERTIFICATE-----" \
--data-urlencode "certificateServer=-----BEGIN CERTIFICATE-----
MII......
-----END CERTIFICATE-----" \
--data-urlencode "certificateChain=-----BEGIN CERTIFICATE-----
MII......
-----END CERTIFICATE-----" \
--data-urlencode "key=-----BEGIN RSA PRIVATE KEY-----
MII......
-----END RSA PRIVATE KEY-----" \
--data-urlencode "notAfter=2025-12-01 08:12:34"