文档中心

Appearance

获取根证书 ​

POST
/openapi/v3/tools/certs/get-root-ca

根据已签发证书及其交付路径，或提供的 PEM 证书链，获取最终根证书。需要 API Key 的订单访问权限；按证书 ID 获取时，还需有该证书的访问和提取权限。

请求参数 ​

Body 参数 application/json ​

cert_id 与 cert_chain 必须提供一个非空值，不能同时提供两个非空值。

参数类型必填说明
cert_idstring二选一已签发证书 ID。返回该证书本次交付路径对应的最终根证书
cert_chainstring二选一PEM 证书链。根据最后一张证书查找根证书，不读取订单交付偏好
cross_chaininteger否仅与 cert_id 配合使用。省略、null 或 0 使用订单偏好和默认配置；候选编号 1000～9999 选择本次路径；-1 / 1 仅本次强制使用旧式不带 / 带交叉链规则

按 cert_id 获取时，如需与证书详情的结果一致，应使用相同的 cross_chain 选择；该参数不保存偏好。候选编号来自查询证书候选链。

本接口严格校验 cross_chain：未列出的整数值、字符串、小数和超出 int32 范围的数字均返回参数错误。使用 cert_chain 时省略 cross_chain；传入数字（包括 0）会返回参数错误。

返回数据 ​

参数类型说明
root_ca_pemstring最终根证书 PEM；不包含叶证书和中间证书

按证书 ID 获取时，直接使用本次交付解析的根证书。证书尚未签发、交付结果缺少叶证书或无法取得根证书时，返回 get_root_cert_failed；不会改用其他路径猜测根证书。证书链选择、权限等错误按标准 code/error 返回，参见证书链错误码。

请求示例 ​

将证书 ID、鉴权值及候选编号 1002 替换为账户下的实际值；沿用默认交付时省略 cross_chain。

bash
curl -X POST 'https://api.certcloud.cn/openapi/v3/tools/certs/get-root-ca' \
  -H 'Content-Type: application/json' \
  -H 'X-CC-Auth-Key: your-auth-key' \
  -H 'X-CC-Key-ID: your-key-id' \
  --data '{"cert_id":"F7vbIVYL","cross_chain":1002}'

按 PEM 证书链查找时，将请求体替换为以下内容，并使用实际 PEM 材料：

json
{
  "cert_chain": "-----BEGIN CERTIFICATE-----\n...\n-----END CERTIFICATE-----\n"
}

响应示例 ​

200成功
json
{
  "code": "success",
  "data": {
    "root_ca_pem": "-----BEGIN CERTIFICATE-----\n...\n-----END CERTIFICATE-----\n"
  }
}