CDN >
API 文档 >
域名管理 >
API 接口 >
证书相关
证书相关
最近更新时间:2018-12-10 16:30:25
上传证书
用户上传证书的接口, 注意我们不会自动补全证书链,需要用户自己补全
请求包
POST /sslcert
{
Cert
}
参数解释
参数 |
类型 |
必填 |
含义 |
Cert |
object |
是 |
结构请参考 证书 |
返回包
{
"certID": <CertID>
}
参数解释
错误码
错误码 |
含义 |
400500 |
超过用户绑定证书最大额度 |
404906 |
https证书解码失败 |
400323 |
验证https证书链失败 |
400322 |
https证书有效期太短 |
400329 |
https证书过期 |
请求示例
POST /sslcert HTTP/1.1
Authorization: QBox 0tf5awMVxwf8WrEvrjtbiZrdRZRJU-91JgCqTOC8:6oxDOtOXVEfcR8PPuAscmWjVRS8=
Content-Type: application/json
Host: api.qiniu.com
{
"name": "test.qbox.net",
"common_name": "test.qbox.net",
"ca": "-----BEGIN CERTIFICATE-----\nMIIE4zCCA8ugAwIGDgIQS8bzWqULBRrgekETXZfAuTANBgkqhkiG9w0BAQsFADBP\nMQswCQYDVQQGEwJDTjEaMBgGA1UEChMRV29TaWduIENBIExpbWl0ZWQxJDAiBgNV\nBAMMG0NBIOayg+mAmuWFjei0uVNTTOivgeS5piBHMjAeFw0xNjA2MTYwNzMyMzda\nFw0xODA2MTYwNzMyMzdaMBkxFzAVBgNVBAMMDmZ1emh1LnFib3gubmV0MIIBIjAN\nBgkqhkiG9w0BAQEFBBOCAQ8AMIIBCgKCAQEAlJJM7hokv++N8zRgPS48BMYR2RmS\nUGLAepVcO3Lr85Q7UnXpUa6vJeg6O6X0oEL410tOn4GnGzXnAbhKezx6tyihQV1x\nE+AxEVZh7G74G+uoXk6whauhepx51I6/HFO+THQVel0tNXjFnk7IpmvsrlhmjvLY\nLK6uXpPuUFemPf42IyM2e76zQg9TriBffg7z5Th1DvSnflJwu0utW5cUfkLnMU2d\nXCt2b446rp1JTbQcQL0GGrJWTXA9Gaemd6weQ1KZWROw7uvWBiS68GdflNBB1fRn\nWefXV6MKM+fhIdBJAuRU3z/+qdFGBHSLr1WuaZjZDvNnERah3dIhLuETbwIDAQAB\no4IB7zCCAeswDgYDVR0PAQH/BAQDAgWgMB0GA1UdJPPWMBQGCCsGAQUFBwMCBggr\nBgEFBQcDATAJBgNVHRMEAjAAMB0GA1UdDgQWBBRVEXaqEIT1oaTHeaTWhul9goY0\ntjAfBgNVHSMEGDAWgBQw2nSG8yiQVp7XMTHCvVnNkxI5HTB/BggrBgEFBQcBAQRz\nMHEwNQYIKwYBBQUHMAGGKWh0dHA6Ly9vY3NwMi53b3NpZ24uY24vY2EyZzIvc2Vy\ndmVyMS9mcmVlMDgGDDsGAQUFBzAChixodHRwOi8vYWlhMi53b3NpZ24uY24vY2Ey\nZzIuc2VydmVyMS5mcmVlLmNlcjA+BgNVHR8ENzA1MDOgMaAvhi1odHRwOi8vY3Js\nczIud29zaWduLmNuL2NhMmcyLXNlcnZlcjEtZnJlZS5jcmwwXQYDVR0RBFYwVIIO\nZnV6aHUucWJveC5uZXSCD2Z1emh1MS5xYm94Lm5ldIIPZnV6aHUyLnFib3gubmV0\ngg9mdXpodTMucWJveC5uZXSCD2Z1emh1NC5xYm94Lm5ldDBPBgNVHSAESDBGMAgG\nBmeBDAECATA6BgsrBgEEAYKbUQEBAjArMCkGCCsGAQUDCwIBFh1odHRwOi8vd3d3\nLndvc2lnbi5jb20vcG9saWN5LzANBgkqhkiG9w0BAQsFAAOCAQEATSSAEHvWVRQF\nJx5deZybUWxDJSSFnI9bHJg/OGbPNZQobSPp6XT1+KavbB3KpCg8SJgFM/g+TXDR\nBdFRaula4LSlteBpPUtWZMDC+HXhOCOSyxUYD2+15F4IckpA3fBIcDoN4152e+SO\ndS0eKbedSr7U2NFrcmfF3fUrWfz+AzaiamFPakBofv/1AtGwK6T7M6xhEZmJzpWW\nziNvB/t4t/R3KXLJA3wrCNTm9ijsf95YOjFPWBS+FRV+0mic5eCOVpVSJq05mBIA\nRAJ4h3CW0fsOtJfxyvB2mhMTZjqBYL+1tsRIddzTqidfvaaw2zA7j1Mn9eU1Zi7g\nZ+0yRrfqhQ==\n-----END CERTIFICATE-----\n\n-----BEGIN CERTIFICATE-----\nMIIFlDBBA3ygAwIBAgIQAViMOjUHs/iXIxx2t++F3TANBgkqhkiG9w0BAQsFADBG\nMQswCQYDVQQGEwJDTjEaMBgGA1UEChMRV29TaWduIENBIExpbWl0ZWQxGzAZBgNV\nBAMMEkNBIOayg+mAmuagueivgeS5pjAeFw0xNDExMDgwMDU4NThaFw0yOTExMDgw\nMDU4NThaME8xCzAJBgNVBAYTAkNOMRowGAYDVQQKExFXb1NpZ24gQ0EgTGltaXRl\nZDEkMCIGA1UEAwwbQ0Eg5rKD6YCa5YWN6LS5U1NM6K+B5LmmIEcyMIIBIjANBgkq\nhkiG9w0BAQEFAAOCAQ8AMIIBCgKCAQEA0JMBh1z5ihKZLtSptut+daPq6CIovna/\n2uswQNsecCE4v+pEZ5djMblHQwzu1ciAav06jGTK7c6lRB4Sbb82hoXUUnZ5jBao\nRDNPM3NagriXz06P3Mm2FJXtzWKT73Nw4gu+TnbdtLildjf7EOCpZFUC76e8svcO\ntfJpRR0dDSui5xNH7E1zEnJBCL3hvyVnhWu6KWfKyiAHL25IEK1bEQmHAZCePcJp\neiSDPE9URMF8iiurgXivk2Hi9NKKHOByKr0AlNUxWM0qjTv5FivrmrqvFnF5+oPV\ncZUWyDbEocauums8RjgYaqaD2qv7mCU3uaOzCWIijCPadMXtHXUqOwIDAQABo4IB\nczCCAW8wDgYDVR0PAQH/BAQDAgEGMB0GA1UdJQQWMBQGCCsGAQUFBwMCBggrBgEF\nBQcDATASBgNVHRMBAf8ECDAGAQH/AgEAMC8GA1UdHwQoMCYwJKAioCCGHmh0dHA6\nLy9jcmxzMi53b3NpZ24uY24vY2EyLmNybDBwBggrBgEFBQcBAQRkMGIwJgYIKwYB\nBQUHMAggGmh0dHA6Ly9vY3NwMi53b3NpZ24uY24vY2EyMDgGCCsGAQUFBzAChixo\ndHRwOi8vYWlhMi53b3NpZ24uY24vY2EyZzItc2VydmVyMS1mcmVlLmNlcjAdBgNV\nHQ4EFgQUMNp0hvMokFae1zExwr1ZzZMSOR0wHwYDVR0jBBgwFoAU4E2/3JtBXRPo\nZPCn6RWk4YHBujEwRwYDVR0gBEAwPjA8Bg0rBgEEAYKbUQYBAgICMCswKQYIKwYB\nBQUHAgEWHWh0dHA6Ly93d3cud29zaWduLmNvbS9wb2xpY3kvMA0GCSqGSIb3DQEB\nCwUBB4ISDQBbCJgtcYOHa2WELfGAcTXZawWomqwm56yyVnowYt+4F5chlEdx8SRu\naYPzurYbMJuY0u1fs7NqmFw/A/oXbNy0j37h2fOWVVVayGQIPtw8i3yAaIGTyEp5\nlHQhjKebBq6SyRzSyrzQzWNst8pZlLH51m3KR1vs2zXPWcXmu3zyAc7p+Bghv0N/\n/wo98IKJSXHscLMh5bXBVQLyd/et/YnN2MzHXJHN5ZrSby8P4WAWtr2AC0bl3922\nKUnzHCBKIM4VAxNXOhuXt5pn1yoyKbFh/xGbpnMtFBud5KEPCPR7umQRiESRYsLy\naMx0INAHknGLevWUKdAF9PTX5Yt+LIwNiYmZsIJYCA2vEmhXWoLaz6xKySt6jDhG\n2ITIuuz6dY5sJMV5eDFnrWMAR3qTHBy5TGF4nWtsHuADhx0vkTdlodVxZaDI5VuN\nDjCfhAvMpDvMQc5I4CuSLTtyzUMMsIKSxlG58FQ/S0nVfqQlpJDzt+7pSW1fb0wF\ntyQjVsUymi/o0Q8CNJxvKGDeQiAvYwsjd1kWxKpiV+uXcqLlPUTdnv5jP7oNE2uL\nrCk64HjrrqEDIShimAuTKxXpNUbknxGehrtEIQcXfsl6MDJhmPuwx/9tzdu9uOYy\nE9MX9CFzVIWohrOAOVFtWcYTzi/LhyTDIZebcHNeaxdjedEoLB44oQ==\n-----END CERTIFICATE-----",
"pri": "-----BEGIN RSA PRIVATE KEY-----\nMIIEpyIBAAKCAQEAr4wMqT9pzPyLG7uAdH/8igjvtAWFnDuPKBQS0yQqPGebEvLi\ne9HztzdimPbSrtrBDsB2WJBIMmHrAKXzxeqx40snt5JCJfI1ogYqTvQ5QdkiDrL7\nXyoIPGWyz1FiZ8b1mA5/gVeW6l86LFcUTVmVc4ivQ75u3OyuqxqV9WXzD4BbbE9E\nUusoCC6ISHGgDgjJLsVl9jdM1Q9Gnhsu+PU/j3bqHYmrZ52wBbF18V4ZVOXnS1RN\nld2LgOgzqkd497xYLxRMbg0hldG8DKgqIFVuc+I7OfYJhmDqQE/uvndPv0Ae64WN\noFM62yLgMEiN5h4GP+FnJCV/20MzsfX5B8EjQQIDAQABAoIBAASiyCNQkxqoboPa\nw47Kt03jHiHOuwYYEw+J2dY/rwoFv5REUTDtUkML2FkF3KS6OW1frbMTSrAiQpkz\nk2YDbN5Iee8ovUHgsnlPHHSAZyzbCcxAU6/XeEdLCr9bl3kPiaUR40dfG34glL9U\nGeDHOBGIjKisnuN18Htrh3CxzWr4IN26qo7lbrLEh8qle8F4OMroX1lJZN7N7o7P\nvMWrrvwlmj06vD15mY5vBG+rXvLOSTcIkSuA7AK6rgiCRuFDW1zBDQNgfhtKZvUB\n7w/5sERLpx9Tfqsl0A8Rd615xpV0Lnx5kmtmtIQaWBMW28peTjlUw1PdHZtMMFjx\nDOoS/akCgYEA44vKUXabQX8LCGj5RXE8h7HB7nMOCrssYsrYR7sRLni7Y9sfVXw3\nhldhizrNFHO4JWST40yH+lkLdn/Fxls5dYUu9yxo14quq/zY3hADu1ZzGiyeAGsz\nN2at13VYsctV2qoEi8QfJU6bxvdA03Jdxx7kBo35NXl8YaCEwaMIzUkCgYEAxX+q\nlOmD2StCEorzZEPK5FZdTnqgUFPDXf4mf0UrhKSHN0W3aSLS1WHUGwE+UpPL0LUX\nE43MvHRQH8eiWSJzkeD24IYufqwRkNk9FXWGSo8Z54vuO6j+/Pe3yTTf0VaXbIJU\n/KmUQrEaLNAki/Ep42mxS0SWSg/cey9a3Yc1/jkCgYBvG7Y52wFqlN9NRvzY5Lca\nxzib94BWyxicUNIVDIoSOA/AbaG6O0JdjdNqidbT8sFrONZhud/35X0Mas2m0qqW\n8OaC+SNkhDqQftFidU1tL4RatoicSbwjhDbEq18YyeHtOPGpUaWnsN+t4tO7q++Q\nqEvNy4txignrEhdg+fv1SQKBgB+Ex1lqhvMylyHUcRFwTEHykoOCyHDpXUVz2Pr4\ntABALaAhjSrHNvR831fL9AFDuwQ80kj5mVH+EgdwWbV17RG74Epmv6bRmSAPu1Lg\nZaUif1TXnRaCWudONVN0D8Ad3J6hkiScf5/BGddLBHoc671yUawcbwu0ylASd6Lh\nADnpAoGBAM40gO2n4N6g+BckdZaTTZYlzecVx4PHiZWM/vBtw603NAPczLC06jEJ\nRwaaOZvbApA+omyIDcVttTTwUmdd1BNnasslE2gmHJWRXZA/RjgMXoOwB6G1Jlk3\n9JF4ljvEeeRoKmuDJRsSn9w51y/ZtxUcfIypWa1hPjRSsDe8sXqV\n-----END RSA PRIVATE KEY-----"
}
删除证书
用户删除证书的接口
请求包
DELETE /sslcert/<CertID>
Authorization: QBox <AccessToken>
参数解释
返回包
{}
错误码
错误码 |
含义 |
400401 |
无此证书 |
404908 |
无权操作该证书 |
400611 |
证书已绑定域名 |
获取证书
用户获取单个证书的接口
请求包
GET /sslcert/<CertID>
Authorization: QBox <AccessToken>
参数解释
返回包
{
Cert
}
参数解释
参数 |
类型 |
含义 |
Cert |
object |
结构请参考 证书 |
错误码
错误码 |
含义 |
400401 |
无此证书 |
404908 |
无权操作该证书 |
获取证书列表
用户获取证书列表的接口
请求包
GET /sslcert?marker=<Marker>&limit=<Limit>
Authorization: QBox <AccessToken>
参数解释
参数 |
类型 |
含义 |
Marker |
string |
用于标示从哪个位置开始获取证书列表。不填或空表示从头开始 |
Limit |
int |
返回的最大域名个数。默认 100 |
返回包
{
"marker": <Marker>,
"certs": [
<Cert>,
...
]
}
参数解释
参数 |
类型 |
含义 |
Marker |
string |
用于标示下一次从哪个位置开始获取证书列表 |
Cert |
object |
结构请参考 证书 |
错误码