接口描述:调用本接口查询证书详情信息。
请求方式:get
请求路径:/cert/query-cert-detail
使用说明:
- 支持按照证书备用名或证书ID查询,若两个参数都传,以证书备用名为准
- 由于证书平台经历过迁移,旧平台没有证书ID的字段,因此返回参数id可能不存在
- 单个用户一分钟限制调用10000次,并发不超过100。
请求参数说明:
参数 | 是否必填 | 参数类型 | 示例 | 说明 |
---|---|---|---|---|
name | 否 | string | CA-origin-cert | 证书备注名,name和id必填其中一个,若都填返回name查询结果 |
id | 否 | int | 7034 | 证书id,name和id必填其中一个,若都填返回name查询结果 |
usage_mode | 否 | int | 2 | 证书用途,取值范围:0(加速域名的证书和私钥),1(客户端CA链证书),2(源站CA链证书),3(CDN回源节点证书和私钥),4(加速域名的证书和私钥(国密)),其中1、2、3是双向认证场景使用的证书 |
返回参数说明:
参数 | 参数类型 | 说明 | 示例 | 下级对象 |
---|---|---|---|---|
code | int | 状态码 | 100000 | |
message | string | 结果简述 | 正确返回 | |
result | object | 返回对象 | result |
表 result
参数 | 参数类型 | 说明 | 示例 | 下级对象 |
---|---|---|---|---|
id | int | 证书id | 7034 | |
expires | int | 证书过期时间 | 1914562170 | |
issue | int | 证书颁发时间 | 1599202170 | |
issuer | string | 证书颁发机构 | Internet Widgits Pty Ltd | |
created | int | 证书创建时间 | 1600877997 | |
name | string | 证书备注名称 | aa | |
cn | string | 证书通用名称 | test.ctyun.cn | |
certs | string | 证书公钥信息 | xxx | |
key | String | 证书私钥信息 | xxx | |
sans | array of strings | 证书授权域名,即证书可以被哪些域名使用 | ["a.ctyun.cn"] | |
usage_mode | int | 证书用途,0:加速域名的证书和私钥 1:客户端CA链证书 2:源站CA链证书 3:CDN回源节点证书和私钥 4:加速域名的证书和私钥(国密);其中1、2、3是双向认证场景使用的证书 | 0 |
示例 :
请求路径:https://cdnapi-global.ctapi.ctyun.cn/cert/query-cert-detail
示例1 :
请求:https://cdnapi-global.ctapi.ctyun.cn/cert/query-cert-detail?name=xxxx
返回结果:
{
"code": 100000,
"message": "success",
"result": {
"id": 7034,
"expires": 1914562170,
"issue": 1599202170,
"sans": [
"a.ctyun.cn",
"b.ctyun.cn"
],
"created": 1600877997,
"name": "aa",
"cn": "test.ctyun.cn",
"issuer": "Internet Widgits Pty Ltd",
"certs": "xxx",
"key": "xxx"
}
}
错误码请参考:参数code和message含义