查询回调配置

GET

/openapi/v3/account/callback

查询当前账户保存的回调配置。响应不会返回 access_key。

请求参数

无。

请求示例

curl 'https://api.certcloud.cn/openapi/v3/account/callback' \
  -H 'X-CC-Auth-Key: your-auth-key' \
  -H 'X-CC-Key-ID: your-key-id'

返回数据

参数	类型	说明
url	string	当前回调地址；未配置时为空字符串
disabled	boolean	是否停用业务回调投递
enabled_actions	string[] / null	事件订阅白名单；三态语义见账户回调配置
created_at	string	可选。配置创建时间，使用 CertCloud 系统时区，格式为 YYYY-MM-DD HH:mm:ss；未配置或创建时间为空时省略该字段

200成功

{
  "data": {
    "url": "https://gateway.example.com/callback?token=example",
    "disabled": false,
    "enabled_actions": [
      "cert:expired",
      "order:issued"
    ],
    "created_at": "2026-07-22 10:00:00"
  },
  "code": "success"
}

未配置账户

账户尚未创建回调配置时，接口仍返回成功：data 中包含 url: ""、disabled: false、enabled_actions: null，但完全省略 created_at 字段。已有配置但没有有效创建时间时也会省略该字段。

相关文档

• 更新回调配置
• 测试回调配置