全站加速 > API 文档 > 证书相关

证书相关

最近更新时间: 2024-07-01 15:33:42

上传证书

用户上传证书的接口, 注意我们不会自动补全证书链，需要用户自己补全

请求包

POST /sslcert
Content-Type: application/json
Authorization: QBox <AccessToken>

{
		"name": <Name>,
		"common_name": <CommonName>,
		"pri": <Pri>,
		"ca": <Ca>
}

参数解释

参数	类型	含义
Name	string	证书名称
CommonName	string	通用名称
Pri	string	证书私钥
Ca	string	证书内容

返回包

	{
		"certID": <CertID>
		
	}

参数解释

参数	类型	含义
CertID	string	证书ID

错误码

错误码	含义
400500	超过用户绑定证书最大额度
404906	https证书解码失败
400323	验证https证书链失败
400322	https证书有效期太短
400329	https证书过期

删除证书

用户删除证书的接口

请求包

DELETE /sslcert/<CertID>
Content-Type: application/json
Authorization: QBox <AccessToken>

参数解释

参数	类型	含义
CertID	string	证书ID

返回包

{}

错误码

错误码	含义
400401	无此证书
404908	无权操作该证书
400611	证书已绑定CDN域名
400911	证书已绑定存储域名

获取证书

用户获取单个证书的接口

请求包

GET /sslcert/<CertID>
Content-Type: application/x-www-form-urlencoded
Authorization: QBox <QBoxToken>

参数解释

参数	类型	含义
CertID	string	证书ID

返回包

{
	"name": <Name>,
    	"common_name": <CommonName>,
        "dnsnames": <DNSNames>,  
    	"not_before": <NotBefore>,
     	"not_after": <NotAfter>,
	"pri": <Pri>,
	"ca": <Ca>,
        "create_time": <CreateTime>
}

参数解释

参数	类型	含义
Name	string	证书名称
CommonName	string	通用名称
DNSNames	[]string	DNS域名
NotBefore	int	生效时间
NotAfter	int	过期时间
Pri	string	证书私钥
Ca	string	证书内容
CreateTime	int	创建时间

错误码

错误码	含义
400401	无此证书
404908	无权操作该证书

获取证书列表

用户获取证书列表的接口

请求包

GET /sslcert?product=<Product>&marker=<Marker>&limit=<Limit>
Content-Type: application/x-www-form-urlencoded
Authorization: QBox <QBoxToken>

参数解释

参数	类型	含义
Product	string	全站加速证书列表固定传参"dcdn"
Marker	string	用于标示从哪个位置开始获取证书列表。不填或空表示从头开始
Limit	int	返回的最大证书个数。默认 100

返回包

{
	marker: <Marker>,
	"certs":[{
            "certid": <CertID>,
            "name": <Name>,
    	    "common_name": <CommonName>,
            "dnsnames": <DNSNames>,  
    	    "not_before": <NotBefore>,
     	    "not_after": <NotAfter>,
            "create_time": <CreateTime>
    	}]
}

参数解释

参数	类型	含义
Marker	string	用于标示下一次从哪个位置开始获取证书列表
CertID	string	证书ID
Name	string	证书名称
CommonName	string	通用名称
DNSNames	[]string	DNS域名
NotBefore	int	生效时间
NotAfter	int	过期时间
CreateTime	int	创建时间

错误码

错误码	含义
404908	无权操作该证书

以上内容是否对您有帮助？