ssl 托管证书接口¶
POST 查询 ssl 托管证书¶
POST /prod-api/cdn/ssl/hosting/describeHosting
Body 请求参数
请求参数¶
| 名称 | 位置 | 类型 | 必选 | 中文名 | 说明 |
|---|---|---|---|---|---|
| Authorization | header | string | 是 | none | |
| body | body | object | 是 | none | |
| » filters | body | [object] | 否 | 搜索条件 | none |
| »» label | body | string | 否 | 参数名 | alias:表示别名 |
| »» value | body | [string] | 否 | 值 | 数组类型,传入单个值为模糊搜索,多个值为精确搜索 |
| » pageNum | body | integer(int32) | 是 | 当前页数 | none |
| » pageSize | body | integer(int32) | 是 | 每页显示条目个数 | none |
| » searchHeader | body | object | 否 | 筛选条件 | none |
| »» certEndDay | body | string | 是 | 参数名称(到期时间) | 7:表示 7 天到期 |
详细说明¶
»» label: alias:表示别名 issuerDN:表示证书类型
»» certEndDay: 7:表示 7 天到期 30:表示 30 天到期
返回示例
200 Response
{
"total": 6,
"rows": [
{
"certId": 91,
"status": 0,
"dnsName": "*.demo.com,demoy.com",
"alias": "*.demoy.com",
"sslcrt": "-----BEGIN CERTIFICATE-----\nMIIHlzCCBX+gAwIBAgIQBiis4ELtiiXRwdC6m/B4UzANBgkqhkiG9w0BAQsFADBc\nMQswCQYDVQQGEwJVUzEXMBUGA1UEChMORGlnaUNlcnQsIEluYy4xNDAyBgNVBAMT\nK1JhcGlkU1NMIEdsb2JhbCBUTFMgUlNBNDA5NiBTSEEyNTYgMjAyMiBDQTEwHhcN\nMjQwNDIzMDAwMDAwWhcNMj+Q76tV4/EMUlaU05FL9XPuTv7fdFAGkSNXltAyVABDnVp8uBxF8zSA\nn0d7wuxS8hrDs12Iti/Inz5lpi8igUinXRFB\n-----END CERTIFICATE-----\n-----BEGIN CERTIFICATE-----\nMIIFyzCCBLOgAwIBAgIQCgWbJfVLPYeUzGYxR3U4ozANBgkqhkiG9w0BAQsFADBh\nMQswCQYDVv1sAgEwBwYFZ4EMAQEwCAYGZ4EMAQIBMAgGBmeBDAEC\nAjAIBgZngQwBAgMwDQYJKoZIhvcNAQELBQADggEBAAfjh/s1f5dDdfm0sNm74/dW\nMbbsxfYV1LoTpFt+3MSUWvSbiPQfUkoV57b5rutRJvnPP9mSlpFwcZ3e1nSUbi2o\nITGA7RCOj23I1F4zk0YJm42qAwJIqOVenR3XtyQ2+9i1R4Fg5zPNvHs2BbIve0vkwxAy+R4727qYzl3027w9jEFC6HMXRaDc=\n-----END CERTIFICATE-----",
"subjectDN": "*.demoyy.com",
"issuerDN": "Rapi SHA256 2022 CA1",
"beginTime": null,
"endTime": "2025-04-23 07:59:59",
"createTime": "2024-09-07 17:12:14"
}
],
"code": 200,
"msg": "成功"
}
201 Response
返回结果¶
| 状态码 | 状态码含义 | 说明 | 数据模型 |
|---|---|---|---|
| 200 | OK | none | Inline |
| 201 | Created | none | Inline |
| 401 | Unauthorized | none | Inline |
| 403 | Forbidden | none | Inline |
| 404 | Not Found | none | Inline |
返回数据结构¶
状态码 200
| 名称 | 类型 | 必选 | 约束 | 中文名 | 说明 |
|---|---|---|---|---|---|
| » total | integer | true | none | none | |
| » rows | [object] | true | none | none | |
| »» certId | integer | false | none | 证书 ID | none |
| »» status | integer | false | none | 状态 | 0:表示上传托管 1:表示状态码除以 10 后的余数是否等于 1,等于 1 时为待验证 2:表示处理中 3:表示已颁发 4:表示验证失败 |
| »» dnsName | string | false | none | 其他域名 | none |
| »» alias | string | false | none | 别名 | none |
| »» sslcrt | string | false | none | 证书内容 | none |
| »» subjectDN | string | false | none | 通用名称 | none |
| »» issuerDN | string | false | none | 证书类型 | none |
| »» beginTime | null | false | none | 开始时间 | none |
| »» endTime | string | false | none | 到期时间 | none |
| »» createTime | string | false | none | 提交时间 | none |
| » code | integer | true | none | none | |
| » msg | string | true | none | none |
数据模型¶
SearchFilterVo
SearchFilterVo
属性¶
| 名称 | 类型 | 必选 | 约束 | 中文名 | 说明 |
|---|---|---|---|---|---|
| label | string | false | none | none | |
| value | [string] | false | none | none |
DescribeSSLHostingVO
{
"country": "string",
"domainId": 0,
"filters": [
{
"label": "string",
"value": ["string"]
}
],
"pageNum": 0,
"pageSize": 0,
"params": {},
"searchHeader": {},
"searchValue": "string",
"tableCul": {
"property1": "string",
"property2": "string"
},
"userId": 0
}
DescribeSSLHostingVO
属性¶
| 名称 | 类型 | 必选 | 约束 | 中文名 | 说明 |
|---|---|---|---|---|---|
| country | string | false | none | none | |
| domainId | integer(int64) | false | none | none | |
| filters | [SearchFilterVo] | false | none | none | |
| pageNum | integer(int32) | true | none | 当前页数 | none |
| pageSize | integer(int32) | true | none | 每页显示条目个数 | none |
| params | object | false | none | none | |
| searchHeader | object | false | none | 筛选条件 | none |
| searchValue | string | false | none | none | |
| tableCul | object | false | none | none | |
| » additionalProperties | string | false | none | none | |
| userId | integer(int64) | false | none | none |