文档中心

Appearance

查询证书候选链 ​

GET
/openapi/v3/certs/:id/certificate-chains

查询已签发证书的实际 ICA 信息和当前可选的交付路径。需要订单访问及该证书的提取权限。该接口不修改偏好，也不返回证书 PEM；证书内容通过获取证书详情读取。

请求参数 ​

路径参数 ​

参数类型必填说明
idstring是已签发证书 ID，必须可被当前调用者访问

本接口无查询参数，一次返回全部当前可选路径，无需分页。

返回数据 ​

字段类型说明
cert_idstring证书 ID
issuer_materialobject / null实际签发 ICA 的身份信息，见 MaterialIdentity
optionsarray[object]全部当前可选的登记路径，见 Candidate；无可选路径时为 []

请求示例 ​

替换示例证书 ID 和鉴权值后调用。

bash
curl 'https://api.certcloud.cn/openapi/v3/certs/F7vbIVYL/certificate-chains' \
  -H 'X-CC-Auth-Key: your-auth-key' \
  -H 'X-CC-Key-ID: your-key-id'

响应示例 ​

以下编号、名称和指纹仅为示例；实际选择请使用本账户接口返回的值。

200成功
json
{
  "code": "success",
  "data": {
    "cert_id": "F7vbIVYL",
    "issuer_material": {
      "sha1": "AAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAA",
      "common_name": "Example Issuing CA",
      "subject_ou": "",
      "not_before": "2025-01-01T00:00:00Z",
      "not_after": "2035-01-01T00:00:00Z"
    },
    "options": [
      {
        "cross_chain": 1002,
        "display_name": "示例原生交付链",
        "chain_materials": [
          {
            "sha1": "BBBBBBBBBBBBBBBBBBBBBBBBBBBBBBBBBBBBBBBB",
            "common_name": "Example Root CA",
            "subject_ou": "",
            "not_before": "2025-01-01T00:00:00Z",
            "not_after": "2035-01-01T00:00:00Z"
          }
        ]
      }
    ]
  }
}

处理说明 ​

options 只包含当前可新选择的路径，不可选项会被过滤。options=[] 表示没有可新选择的登记路径，不代表旧式默认链一定无法交付。

如需查看已保存的设置，调用查询订单交付偏好；如需确认本次实际交付路径，读取证书详情中的 Certificate.cross_chain。请求失败时按证书链错误码处理。