跳转至

ssl 托管证书接口

POST 查询 ssl 托管证书

POST /prod-api/cdn/ssl/hosting/describeHosting

Body 请求参数

{
  "pageNum": 10,
  "pageSize": 1
}

请求参数

名称 位置 类型 必选 中文名 说明
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

{
  "label": "string",
  "value": ["string"]
}

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