查询相关接口

更新时间：2026-08-15

获取已购证书列表

接口描述

本接口用于查询用户已购买的证书，使用分页

请求结构

Plain Text

1> GET http://cas.baidubce.com/v3/openapi/query/?pageNo=1&pageSize=3
2> Authorization: authorization string
3> Host: cas.baidubce.com
4> x-bce-console-rpc-id: e69c8fff-166b-4c82-87c1-7aa3ba309d5c
5> x-bce-date: 2020-04-27T02:43:18Z

请求头域

除公共头域外，无其它特殊头域。

请求参数

参数名称	类型	是否必需	参数位置	描述
version	String	是	URL参数	API版本号
pageNo	int	否	Query参数	页码数，默认1，最小1
pageSize	int	否	Query参数	单页大小，默认10，取值范围 1~100
brand	String	否	Query参数	证书品牌取值见附录 CertBrand
certType	String	否	Query参数	证书类型选值见附录 CertType
status	String	否	Query参数	证书状态选值见附录 CertStatus
order	String	否	Query参数	排序方式，ASC 升序 / DESC 降序，默认 DESC

响应头域

除公共头域外，无其它特殊头域。

响应参数

参数名称	类型	描述
totalCount	int	一共有证书数量
result	list	证书列表，字段见附录 CertDetails

请求示例

Plain Text

1 > GET http://cas.baidubce.com/v3/openapi/query/?pageNo=1&pageSize=3
2 > Authorization: bce-auth-v1/5c36beca06ab4616b7969fe0e768d660/2020-04-27T02:43:18Z/3600/host;x-bce-console-rpc-id;x-bce-date/841f0ebe49d9b3fd2abfc33b71d53e534a6460fc55e6bfbe96a6f1cc5d163ae6
3 > Host: cas.baidubce.com
4 > x-bce-console-rpc-id: e69c8fff-166b-4c82-87c1-7aa3ba309d5c
5 > x-bce-date: 2020-04-27T02:43:18Z

响应示例

Plain Text

1 < Cache-Control: no-cache
2 < Content-Length: -1
3 < Content-Type: application/json;charset=UTF-8
4 < Date: Mon, 27 Apr 2020 02:43:21 GMT
5 < Server: BWS
6 < transfer-encoding: chunked
7 < X-Bce-Gateway-Region: NJ
8 < X-Bce-Request-Id: c994f260-c77a-417f-9aa9-26cefecdec36
9 {
10    "totalCount": 32,
11    "result": [{
12        "certType": "DV",
13        "productType": "SINGLE",
14        "expireTime": "2018-07-17T23:59:59Z",
15        "createTime": "2017-07-17T07:10:01Z",
16        "duration": 0,
17        "productId": "90988831-bd80-11e7-a065-2c44fd7f89bd",
18        "brand": "SSLTRUS",
19        "domainNumber": 0,
20        "wildcardNumber": 0,
21        "status": "EXPIRED",
22        "domainName": "www.lss-qa.com"
23    }, {
24        "certType": "DV",
25        "productType": "SINGLE",
26        "expireTime": "2018-07-17T23:59:59Z",
27        "createTime": "2017-07-17T07:10:18Z",
28        "duration": 0,
29        "productId": "90988ac4-bd80-11e7-a065-2c44fd7f89bd",
30        "brand": "SSLTRUS",
31        "domainNumber": 0,
32        "wildcardNumber": 0,
33        "status": "EXPIRED",
34        "domainName": "abc.lss-qa.com"
35    }, {
36        "certType": "DV",
37        "productType": "SINGLE",
38        "expireTime": "2018-07-28T23:59:59Z",
39        "createTime": "2017-07-28T04:10:33Z",
40        "duration": 0,
41        "productId": "909b6d34-bd80-11e7-a065-2c44fd7f89bd",
42        "brand": "SSLTRUS",
43        "domainNumber": 0,
44        "wildcardNumber": 0,
45        "status": "EXPIRED",
46        "domainName": "mysandbox.lss-qa.com"
47    }]
48   }

免费证书购买限制检查

接口描述

本接口用于查询用户是否可以继续购买免费证书

请求结构

Plain Text

1> GET http://cas.baidubce.com/v3/openapi/query/check
2> Authorization: authorization string
3> Host: cas.baidubce.com
4> x-bce-console-rpc-id: e69c8fff-166b-4c82-87c1-7aa3ba309d5c
5> x-bce-date: 2020-04-27T02:43:18Z

请求头域

除公共头域外，无其它特殊头域。

请求参数

参数名称	类型	是否必需	参数位置	描述
version	String	是	URL参数	API版本号

除 version 外，无其它请求参数（check 为路径的一部分，不需要额外传参）。

响应头域

除公共头域外，无其它特殊头域。

响应参数

参数名称	类型	描述
freeCount	int	一共有免费证书配额
enablePurchaseDV	boolean	当前是否可以继续免费购买

请求示例

Plain Text

1 > GET http://cas.baidubce.com/v3/openapi/query/check
2 > Authorization: bce-auth-v1/5c36beca06ab4616b7969fe0e768d660/2020-04-27T07:30:50Z/3600/host;x-bce-  console-rpc-id;x-bce-date/c359d7207b0bef14c68e79532948056134a9f385fc5fed3a4454bd196e88ddd5
3 > Host: cas.baidubce.com
4 > x-bce-console-rpc-id: 883bacf4-3e9e-41e1-92f4-8da87ae4f99f
5 > x-bce-date: 2020-04-27T07:30:50Z

响应示例

Plain Text

1 < Cache-Control: no-cache
2 < Content-Length: -1
3 < Content-Type: application/json;charset=UTF-8
4 < Date: Mon, 27 Apr 2020 07:30:52 GMT
5 < Server: BWS
6 < transfer-encoding: chunked
7 < X-Bce-Gateway-Region: SZ
8 < X-Bce-Request-Id: 420bdb80-e273-4e97-a804-b95a71502413
9{"freeCount":5,"enablePurchaseDV":true}

附录

CertBrand（证书品牌）

取值	描述
SECURESITE	DigiCert SecureSite
GEOTRUST	GeoTrust
GLOBALSIGN	GlobalSign
CFCA	CFCA
TRUSTASIA	TrustAsia
DIGICERT	DigiCert Basic
SSLTRUS	锐安信
UNITRUST	UniTrust

CertType（证书类型）

取值	描述
DV	域名型
OV	企业型
EV	增强型
OVPRO	企业型专业版（OV PRO）
EVPRO	增强型专业版（EV PRO）

CertStatus（证书状态）

取值	描述
APPLY_PENDING	待申请
APPLYING	申请中
NORMAL	申请成功
FAILED	申请失败
RENEW_PENDING	待续费
RENEW_INITIAL	待完成续费订单
RENEWING_TO_BE_APPLY	续费中-待申请
RENEWING	续费中-申请中
RENEW_NORMAL	续费成功
REPLACING	重新颁发中
REPLACING_FAILED	重新颁发失败
REPLACING_NORMAL	重新颁发成功
REPLACING_CONFIRM	重新颁发待确认
REPLACE_CA	重颁发信息确认后待提交至CA
EXPIRED	已过期
DELETED	已删除
REJECTED	重新颁发被拒绝

CertDetails（证书详情，值为 null 的字段不返回）

参数名称	类型	描述
productId	String	证书ID
productName	String	产品名称
brand	String	证书品牌
certType	String	证书类型，见 CertType
productType	String	产品类型（如 SINGLE）
domainNumber	int	标准域名数量
wildcardNumber	int	通配符域名数量
status	String	证书状态，见 CertStatus
processStatus	String	申请流程状态
applyTime	String(UTC)	申请时间
submitTime	String(UTC)	提交时间
expireTime	String(UTC)	过期时间
createTime	String(UTC)	创建时间
effectTime	String(UTC)	生效时间
errorMessage	String	失败原因
verifyMode	String	域名验证方式
domainName	String	主域名
bindDomains	list	绑定的域名列表
value	String	DNS 或文件验证内容
fileUrl	String	文件验证 URL
dnsName	String	DNS 验证名称
host	String	CNAME 验证 host
cnamevalue	String	CNAME 验证值
type	String	验证类型
httpFilename	String	HTTP 验证文件名
httpvalue	String	HTTP 验证内容
leftTime	Long	验证剩余时间
downloadSupported	boolean	是否支持下载
duration	int	购买时长
timeUnit	String	时长单位

评价此篇文章

有帮助没帮助

错误码

价格相关接口

百度智能云

SSL证书服务 CAS

SSL证书服务 CAS

查询相关接口

获取已购证书列表

免费证书购买限制检查

附录

CertBrand（证书品牌）

CertType（证书类型）

CertStatus（证书状态）

CertDetails（证书详情，值为 null 的字段不返回）