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...
# 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"