请求URL: domain/certificate (POST)
接口请求域名:
cdn.api.baishan.com
接口版本:v2
证书的新增与修改
注意：
以下请求参数列表仅列出了接口请求参数，正式调用时需要加上公共请求参数，见公共请求参数页面。
参数支持 multipart/form-data、json 格式
| 参数名 | 数据类型 | 是否必须 | 说明 |
|---|---|---|---|
| certificate | string | 是 | 证书内容, base64的证书内容, 或证书文件的方式 |
| key | string | 是 | 证书秘钥内容, base64的秘钥内容, 或秘钥文件的方式 |
| name | string | 是 | 证书名称, (仅允许字母,数字,下划线,.), 0-64个字符 |
| cert_id | int | 否 | 证书ID, 传入证书ID时, 将对该证书进行修改操作, 无证书ID, 则进行新增证书操作 |
| user_name | string | 否 | 默认不传，证书归属自己，通过传递账号名可以将证书关联给自己下的其他主账号 |
注意:
- 新增证书时, 参数cert_id无需设置, 该参数仅在需要修改证书时传递.
- 修改证书时, 如若旧证书中绑定了相关域名, 那么要修改的新证书所支持的域名列表中,需要包含原有旧证书已绑定的所有域名, 在程序检测通过后才会执行更新, 否则抛出相关的提示, 未绑定相关域名的证书可直接更新.
#调用方式1: 证书以文本方式进行提交
curl -X POST "https://cdn.api.baishan.com/v2/domain/certificate?token={token}"\
-H "Content-Type: application/json"\
-d '{
"certificate":"-----BEGIN CERTIFICATE-----\r\nMIIHMzCCBhugAwIBAgIQLyOuLqdE9WhqEuM3YWwsAzANBgkqhkiG9w0BAQsFADBE\r\nMQswCQYDVQQGEwJVUzEWMBQGA1UEChMNR2VvVHJ1E4EDYSWXh0US9flnZl8xEDDD\/t8ZO7dmNO6bkiVtA8TYXDuy\r\nwLYJdYN21801njaMGyvQC55n+TUX9eMai9G9dFnexca54nQaU0zG0sk32HZkUp7N\r\nf2mKH4CWrIv0U4znx+3w9rV7BcUmrXs=\r\n-----END CERTIFICATE-----",
"key":"-----BEGIN RSA PRIVATE KEY-----\r\nMIIEpgIBAAKCAQEAvBd8RZv94nDO1LTfa4sw6uuweKjrjU...xUbUm7gSP48mazY7\/x36LYcEmHLhhD\r\n-----END RSA PRIVATE KEY-----",
"name":"certName"
}'
#调用方式2: 证书以文件的方式进行提交
curl -X POST "https://cdn.api.baishan.com/v2/domain/certificate?token={token}"\
-F "certificate=@/tmp/xxx.crt"\
-F "key=@/tmp/xxx.key"\
-F "cert_id=123"\
-F "name=cert_name"json格式
{
"code": 0,
"data": {
"cert_id": "123",
"name": "testName",
"certificate": "-----BEGIN CERTIFICATE-----\r\nMIIHMzCCBhugAwIBAgIQLyOuLqdE9WhqEuM3YWwsAzANBgkqhkiG9w0BAQsFADBE\r\nMQswCQYDVQQGEwJVUzEWMBQGA1U...UX9eMai9G9dFnexca54nQaU0zG0sk32HZkUp7N\r\nf2mKH4CWrIv0U4znx+3w9rV7BcUmrXs=\r\n-----END CERTIFICATE-----",
"key": "-----BEGIN RSA PRIVATE KEY-----\r\nMIIEpgIBAAKCAQEAvBd8R...xUbUm7gSP48mazY7/x36LYcEmHLhhD\r\n-----END RSA PRIVATE KEY-----",
"bind_domains": [],//该证书绑定的相关域名列表
"cert_start_time": "2016-07-27 08:00:00",//证书有效日期起始时间
"cert_expire_time": "2019-06-19 07:59:59"//证书有效日期截止时间
}
}HTTP/1.0 200 OK
Api-Id: 782708629
Content-Type: application/json; charset=utf-8
X-Ratelimit-Grad: minute
X-Ratelimit-Limit: 100
X-Ratelimit-Remaining: 100
X-Retry-After: 41