获取域名的证书 URL--域名服务-火山引擎

文档中心

导航

获取域名的证书 URL

最近更新时间：2024.04.02 15:28:31首次发布时间：2023.09.12 17:49:37

API 说明

API 名称：GetDomainCertificateUrl。
API 域名：open.volcengineapi.com。
API 描述：指定一个域名，获取注册商（新网或者商中）颁发给该域名的证书 URL。该证书不是 SSL 证书，而是在注册期内您拥有该域名的证明。

请求方法

GET

使用限制

节流限制：您每秒最多可以发送 50 个请求。

请求鉴权

每个请求中必须包含鉴权信息。该鉴权信息用以验证请求者的身份。参见请求鉴权。

公共参数

在调用该 API 时，您在请求中必须包含公共参数。在这些公共参数中，以下两个查询参数的取值说明如下：

参数名称	数据类型	是否必选	参数说明
Action	string	是	表示 API 的名称。该参数的取值是`GetDomainCertificateUrl`。
Version	string	是	表示 API 的版本。该参数的取值是 `2022-12-12`。

请求参数

该 API 的请求参数的类型都是请求正文参数。

参数名称	数据类型	是否必选	参数说明	示例
domain	string	是	表示需要获取证书 URL 的域名。	`test.com.cn`

响应正文

参数名称	数据类型	参数说明	示例
domain	string	表示需要获取证书 URL 的域名。	`test.com.cn`
url	string	表示一个证书的 URL。该证书是注册商颁发给该域名的。	参见响应示例

请求示例

GET https://open.volcengineapi.com?Version=2022-12-12&Action=GetDomainCertificateUrl&domain=test.com.cn

响应示例

{
    "ResponseMetadata": {
        "RequestId": "202309121444103B0B9D91133192C75F6E",
        "Action": "GetDomainCertificateUrl",
        "Version": "2022-12-12",
        "Service": "domain_openapi",
        "Region": "cn-north-1"
    },
    "Result": {
        "domain": "test.com.cn",
        "url": "https://dcp.xinnet.com/domain/certInfo?agentCode=agent1234567&timestamp=1694589051450&sign=3c571a7e0bf668ae566044b4ca4va5dd&cnDomainName=test.com.cn"
    }
}

错误码

如果响应正文包含 Error 字段，则表示 API 请求失败。关于更多错误码的信息，参见错误码。