获取证书详情

GET

/openapi/v3/certs/:id

获取证书记录及其详情。pem、ica_pem、not_before、not_after 等字段仅在证书签发后返回。完整字段结构参见公共响应对象。

路径参数

参数	类型	必填	说明
id	string	是	证书 ID

查询参数

参数	类型	必填	说明
cross_chain	int	否	省略或 0 按订单偏好和默认配置交付；传候选路径编号（1000～9999）仅覆盖本次获取。-1 表示不带旧式交叉链，1 表示带旧式交叉链。详见证书链选择与交付

可先查询证书候选链，从返回的 options 中选择路径。此查询参数不保存偏好；要影响后续默认交付，请使用设置订单交付偏好。登记路径不可交付时返回错误，不会自动替换成其他登记路径。

返回数据

参数	类型	说明
Certificate	object	证书详情（响应字段名首字母大写 Certificate）
∟ id	string	证书 ID
∟ common_name	string	通用名称
∟ dns_names	array	备用名称
∟ sign_hash	string	签名摘要
∟ csr	string	证书请求文件 CSR
∟ thumbprint	string	通用 SHA1 指纹，证书签发后有
∟ pem	string	证书 PEM，证书签发后有；使用登记路径时为叶证书，旧式交付保持既有 PEM 格式
∟ ica_pem	string	中间证书 PEM，证书签发后有；使用登记路径时为实际 ICA 及后续交叉中间证书，不含最终自签名根证书
∟ not_before	string	证书开始时间，证书签发后有
∟ not_after	string	证书结束时间，证书签发后有
∟ created_at	string	证书创建时间
∟ enc_encrypted_key	string	加密证书的私钥，适用于国密双证场景
∟ enc_pem	string	加密证书，适用于国密双证场景
∟ key_len	int	加密长度
∟ key_algo	string	加密算法
∟ license_data	string	授权数据
∟ license_name	string	授权文件名，国密证书返回
∟ given_domain	array[string]	CA 赠送的域名（如适用）
∟ revoked	boolean	是否已吊销
∟ status	int	证书状态码
∟ issuer	string	签发者
∟ brand	string	证书品牌
∟ audit_type	string	审核类型
∟ cross_chain	integer	本次实际使用的登记路径编号；使用旧式路径或没有登记路径编号时省略，不返回 null
∟ chain_id	integer	实际签发 ICA 对应的配置 ID；无法唯一匹配配置时省略，不表示订单请求的 ICA
revoke_dcv_val	array[object]	吊销验证信息；无验证值时返回空数组，元素结构同吊销证书响应中的 dcv_val

请求示例

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

const response = await fetch('https://api.certcloud.cn/openapi/v3/certs/F7vbIVYL', {
  headers: {
    'X-CC-Auth-Key': 'your-auth-key',
    'X-CC-Key-ID': 'your-key-id',
  }
})

req, _ := http.NewRequest("GET", "https://api.certcloud.cn/openapi/v3/certs/F7vbIVYL", nil)
req.Header.Set("X-CC-Auth-Key", "your-auth-key")
req.Header.Set("X-CC-Key-ID", "your-key-id")
resp, _ := http.DefaultClient.Do(req)

import requests

resp = requests.get(
    'https://api.certcloud.cn/openapi/v3/certs/F7vbIVYL',
    headers={
        'X-CC-Auth-Key': 'your-auth-key',
        'X-CC-Key-ID': 'your-key-id',
    }
)

响应示例

以下示例为实际选中登记路径的响应；1002 和 7 仅展示格式，请以实际返回值为准。

200成功

{
  "data": {
    "Certificate": {
      "id": "F7vbIVYL",
      "common_name": "example.com",
      "dns_names": [
        "example.com"
      ],
      "sign_hash": "SHA256",
      "csr": "-----BEGIN CERTIFICATE REQUEST-----\r\n...\r\n-----END CERTIFICATE REQUEST-----\r\n",
      "thumbprint": "70DAABC42BEE489AE7CDA3671766C37484E02960",
      "pem": "-----BEGIN CERTIFICATE-----\n...\n-----END CERTIFICATE-----\n",
      "not_before": "2026-10-01 00:00:00",
      "not_after": "2026-12-29 23:59:59",
      "ica_pem": "-----BEGIN CERTIFICATE-----\n...\n-----END CERTIFICATE-----\n",
      "created_at": "2026-10-01 00:00:00",
      "cross_chain": 1002,
      "chain_id": 7
    },
    "revoke_dcv_val": []
  },
  "code": "success"
}