获取证书详情

GET

/openapi/v3/certs/:id

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

路径参数

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

查询参数

参数	类型	必填	说明
cross_chain	int	否	获取证书详情时，指定返回的证书链是否携带交叉证书链：2 表示带，-1 表示不带，1 或不传表示按系统默认设置返回

返回数据

参数	类型	说明
Certificate	object	证书详情（响应字段名首字母大写 Certificate）
∟ id	string	证书 ID
∟ common_name	string	通用名称
∟ dns_names	array	备用名称
∟ sign_hash	string	签名摘要
∟ csr	string	证书请求文件 CSR
∟ thumbprint	string	通用 SHA1 指纹，证书签发后有
∟ pem	string	证书 PEM，证书签发后有
∟ ica_pem	string	中间证书 PEM，证书签发后有
∟ 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	int	交叉证书链控制值
∟ chain_id	int	证书链 ID
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',
    }
)

响应示例

200成功

{
  "data": {
    "Certificate": {
      "id": "F7vbIVYL",
      "common_name": "test.isw.app",
      "dns_names": [
        "test.isw.app"
      ],
      "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": "2023-07-11 23:59:59",
      "not_after": "2023-07-11 23:59:59",
      "ica_pem": "-----BEGIN CERTIFICATE-----\n...\n-----END CERTIFICATE-----\n",
      "created_at": "2022-07-12 01:43:53"
    }
  },
  "code": "success"
}