查询域名证书详情

1. 接口描述

接口请求路径：GET /prod-api/cdn/layer7/ssl/describeDomainInfo/{domainId}

describeDomainInfo 用于查询指定域名当前已绑定的证书配置详情，包括证书来源、证书 ID、回源协议及证书状态等。

Token 获取方式见 密钥鉴权。

2. 输入参数

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

参数名称	必选	类型	描述
domainId	是	Integer	Path 参数。域名 ID 示例值：194

3. 示例

示例1 查询域名证书详情

输入示例

GET /prod-api/cdn/layer7/ssl/describeDomainInfo/194

代码调用

请将 {登录域名}、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 DescribeDomainInfoTest {

    public static void main(String[] args) throws Exception {
        String url = "https://{登录域名}/prod-api/cdn/layer7/ssl/describeDomainInfo/194";
        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/describeDomainInfo/194"
    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": {
    "protocol": 0,
    "expectProtocol": 0,
    "DomainCertStatus": "normal",
    "port": 0,
    "domainName": "*.demo.com",
    "certId": 70,
    "source": 1,
    "domainId": 194
  }
}

4. 输出参数

参数名称	类型	描述
code	Integer	状态码。示例值：200
msg	String	提示信息。示例值：操作成功
data	Object	域名证书详情
data.domainId	Integer	域名 ID。示例值：194
data.domainName	String	域名。示例值：*.demo.com
data.port	Integer	端口。示例值：0
data.protocol	Integer	域名当前回源协议，支持以下值： 0：HTTP 1：协议跟随 示例值：0
data.expectProtocol	Integer	证书关联记录中的期望回源协议，取值同 protocol 示例值：0
data.DomainCertStatus	String	证书状态，支持以下值： issuing：颁发中 normal：正常 示例值：normal
data.certId	Integer	绑定的证书 ID。示例值：70
data.source	Integer	证书来源，支持以下值： 0：自有证书 1：托管证书 2：平台颁发（证书记录不存在时默认返回） 示例值：1

5. 错误码

HTTP 状态码 / 业务提示	描述
200	成功
401	未鉴权或 Token 无效
403	无权限
域名信息异常，请刷新后重试	域名不存在或不属于当前账号
证书信息异常，请刷新后重试	域名尚未绑定证书关联记录