查询证书配置域名

1. 接口描述

接口请求路径：GET /prod-api/cdn/layer7/ssl/describeDomains

describeDomains 用于查询当前账号下可用于证书配置的域名列表（最多返回 30 条），可按域名关键字模糊筛选。返回的 label 会附带端口信息（默认端口显示为「默认」）。

Token 获取方式见 密钥鉴权。

2. 输入参数

以下请求参数列表仅列出了接口请求参数和部分公共参数，完整公共参数列表见 公共请求参数。

参数名称	必选	类型	描述
domainName	否	String	Query 参数。域名关键字，模糊匹配（泛域名中的 * 会被忽略） 示例值：demo.com

3. 示例

示例1 查询证书配置域名

输入示例

GET /prod-api/cdn/layer7/ssl/describeDomains

代码调用

请将 {登录域名}、token 替换为实际值。

JavaGo

import org.apache.http.client.methods.CloseableHttpResponse;
import org.apache.http.client.methods.HttpGet;
import org.apache.http.impl.client.CloseableHttpClient;
import org.apache.http.impl.client.HttpClients;
import org.apache.http.util.EntityUtils;

public class DescribeDomainsTest {

    public static void main(String[] args) throws Exception {
        String url = "https://{登录域名}/prod-api/cdn/layer7/ssl/describeDomains";
        String token = "eyJhbGciOiJIUzUxMiJ9.xxxxxx";

        try (CloseableHttpClient httpClient = HttpClients.createDefault()) {
            HttpGet httpGet = new HttpGet(url);
            httpGet.setHeader("Authorization", "Bearer " + token);

            try (CloseableHttpResponse response = httpClient.execute(httpGet)) {
                int statusCode = response.getStatusLine().getStatusCode();
                String body = EntityUtils.toString(response.getEntity(), "UTF-8");
                System.out.println("Status Code: " + statusCode);
                System.out.println("Body: " + body);
            }
        }
    }
}

package main

import (
    "fmt"
    "io"
    "net/http"
)

func main() {
    url := "https://{登录域名}/prod-api/cdn/layer7/ssl/describeDomains"
    token := "eyJhbGciOiJIUzUxMiJ9.xxxxxx"

    req, err := http.NewRequest(http.MethodGet, url, nil)
    if err != nil {
        panic(err)
    }
    req.Header.Set("Authorization", "Bearer "+token)

    resp, err := http.DefaultClient.Do(req)
    if err != nil {
        panic(err)
    }
    defer resp.Body.Close()

    body, err := io.ReadAll(resp.Body)
    if err != nil {
        panic(err)
    }
    fmt.Println("Status Code:", resp.StatusCode)
    fmt.Println("Body:", string(body))
}

输出示例

{
  "msg": "成功",
  "code": 200,
  "data": [
    {
      "id": 490,
      "port": 0,
      "domainName": "11.cc.com",
      "label": "11.cc.com:默认",
      "isActive": 0,
      "status": null,
      "source": null,
      "endTime": null
    },
    {
      "id": 495,
      "port": 0,
      "domainName": "111.33.cinm",
      "label": "111.33.cinm:默认",
      "isActive": 0,
      "status": null,
      "source": null,
      "endTime": null
    }
  ]
}

4. 输出参数

参数名称	类型	描述
code	Integer	状态码。示例值：200
msg	String	提示信息。示例值：成功
data	[DomainCertOption]	域名列表，最多 30 条

5. 错误码

HTTP 状态码 / 业务提示	描述
200	成功
401	未鉴权或 Token 无效
403	无权限

6. 数据模型

DomainCertOption

可选域名项。

参数名称	类型	描述
id	Integer	域名 ID。示例值：490
port	Integer	端口，0 表示默认端口。示例值：0
domainName	String	域名。示例值：11.cc.com
label	String	展示名称。默认端口为 {域名}:默认，非默认端口为 {域名}:{端口}。示例值：11.cc.com:默认
isActive	Integer	是否活跃。示例值：0
status	String	证书状态，可能为 null，支持以下值： issuing：颁发中 normal：正常 示例值：normal
source	Integer	证书来源，可能为 null，支持以下值： 0：自有证书 1：托管证书 2：平台颁发 示例值：1
endTime	String	证书到期时间，可能为 null。示例值：2025-07-01 19:41:53