Page tree
Skip to end of metadata
Go to start of metadata

TRUSTOCEAN API 从 V2 版本开始已经支持 对订单、证书状态的 PUSH 通知,避免您的API请求频率受到限制, 请您尽快联系我们为您设置PUSH 通知接收地址, 而不是使用轮询的方式查询签发状态。

TRUSTOCEAN 的GitHub版本WHMCS模块已经具备初步的接收PUSH签发通知的逻辑,您可以查看该版本的模块进行逻辑自定义以符合您的开发要求。


PUSH通知传递的参数

参数名称类型备注
typestring推送类型,目前仅支持"cert_issued", 此处的参数仅适用于当 type=cert_issued 的推送。后续将会支持 "refund_finished","cancelled","revoked","rejected","expire_in_90_days","expire_in_30_days","expire_in_7_days","expired"
ca_codestringCA证书链代码
cert_codestring证书PEM代码
statusstring固定值, "issued_active"
issued_atstring签发证书的时间戳
paidcertificate_statusstring已经签发的证书状态, 来自CA的状态同步
trustocean_idstring订单编号
vendor_idstring此参数仅供TRUSTOCEAN内部系统调用, 后续可能会移除
certificate_idstring证书唯一之别ID,此编号同样作为 TRUSTOCEAN 网站安全签章的 seal_id
submitted_atstring证书提交时的时间戳
domainsstringJSONencoded 字符串,证书内的所有的域名

接收成功后输出响应

您应该在接收到PUSH消息之后,输出下列各式的JSONencoded的字符串作为确认响应。以告诉TRUSTOCEAN服务器您已经成功接收到了通知。

成功响应
{
    "status": "success"
}

业务说明和提示

当前 PUSH 通知仅推送一次,无论您是否正确接收和处理成功。因此请您在提交 PUSH URL 之前确保您的对应处理程序开发正确,同时应确保您的服务器可以被各 PUSH 服务器访问到。

  • No labels