批量上传证书

更新时间：2025-08-21

接口说明

本接口用于批量上传HTTPS证书

注意：

如果domain已经绑定了一个证书id，则该接口为修改（将用户新上传的证书替换掉证书库中的老证书，且给domain绑定新证书的id）。如果domain之前没有绑定证书，则该接口为上传新证书且将新的证书id绑到domain上。该接口替换老证书后不对证书库中对老证书做处理

method	path	说明
POST	/v2/domain/certificate?action=put	增加or修改domain绑定的certificate

请求体

参数	可选	类型	说明
domains	必选	list	要配置的域名列表，不能超过100个，且这些域名均能和证书内容的DNS names匹配
certificate	必选	certificate	证书内容
https	可选	https	HTTPS关联配置

certificate类型说明

参数	可选	类型	说明
certName	必选	string	证书的名称。长度限制为1-65个字符，以字母开头，只允许包含字母、数字、’-‘、’/’、’.’、’’、’’，Java正则表达式 ^[a-zA-Z]a-zA-Z0-9-/.]{0,64}$
certServerData	必选	string	服务器证书的数据内容 (Base64编码)
certPrivateData	必选	string	证书的私钥数据内容 (Base64编码)
certLinkData	可选	string	证书链数据内容 (Base64编码)
certType	可选	int	证书类型,值为1,表服务端证书,不能传客户端证书

https类型说明

参数	可选	类型	说明
httpRedirect	可选	bool	为true时将HTTP请求重定向到HTTPS（重定向状态码为httpRedirectCode所配置），默认为false，当enabled=false此项无效，不可与httpsRedirect同时为true
httpRedirectCode	可选	int	重定向状态码，可选值301/302，默认302，当enabled=false此项无效，httpRedirect=false此项无效
httpsRedirect	可选	bool	为true时将HTTPS请求重定向到HTTP重定向状态码为httpsRedirectCode所配置），默认为false，当enabled=false此项无效，不可与httpRedirect同时为true
httpsRedirectCode	可选	int	重定向状态码，可选值301/302，默认302，当enabled=false此项无效，httpsRedirect=false此项无效
http2Enabled	可选	bool	开启HTTP2特性，默认true，当enabled=false此项无效
disableHttpsSpider	可选	string	跳转时排除包含该字段ua值的请求

响应体

参数	可选	类型	说明
certId	必选	string	证书入库后的certId

请求示例

Text

1POST /v2/domain/certificate?action=put
2{
3    "domains": [
4        "*.baidu.com",
5        "test.baidu.com"
6    ],
7    "certificate": {
8        "certName": "test",
9        "certServerData": "-----BEGIN CERTIFICATE-----END CERTIFICATE-----",
10        "certPrivateData": "-----BEGIN RSA PRIVATE KEY-----END RSA PRIVATE KEY-----"
11    }
12}

响应示例

Plain Text

1{"certId":"cert-z086cxsudg2k"}

查询HSTS配置

查询开启https域名

内容分发网络 CDN

内容分发网络 CDN

批量上传证书