You need to enable JavaScript to run this app.
导航

验证域名所有权

最近更新时间2023.08.22 12:40:54

首次发布时间2022.11.24 20:57:30

API 说明

API 名称:CheckRetrieveZone
API 域名:open.volcengineapi.com
API 描述:验证您的域名所有权。参见 常见问题 了解域名所有权验证的详细流程。

请求方法

POST

调用限制

每秒最多调用一次。

请求参数

除了以下参数,您还需要 对请求进行鉴权

参数名称数据类型参数类型是否必选参数说明
ActionString查询参数API 的名称。该参数的取值是 CheckRetrieveZone
VersionString查询参数API 的版本。该参数的取值是 2018-08-01
ZoneNameString请求正文参数待验证的域名。域名必须是二级域名,并且不能是泛域名。

响应正文

ResponseMetadata 对象

参数名称
数据类型
参数说明
RequestId
String
标识本次请求的 ID。
Action
String
Action 查询参数的值。
Version
String
API 版本。
Service
String
服务类型。
Region
String
服务所在区域。

Result 对象

如果域名所有权验证成功,该 API 返回 "Success": "true"。如果验证失败,该 API 不返回 Result 对象。同时,该 API 通过 ResponseMetadata 对象返回错误消息 type TXT record not found

示例

请求示例

POST https://open.volcengineapi.com?Version=2018-08-01&Action=CheckRetrieveZone
{
  "ZoneName": "example.com"
}

响应示例:域名所有权验证成功

{
    "ResponseMetadata": {
        "RequestId": "20221101155301010225243125056CA34D",
        "Action": "CheckRetrieveZone",
        "Version": "2018-08-01",
        "Service": "dns",
        "Region": "cn-north-1"
    },
    "Result": {
        "Success": "true"
    }
}

响应示例:域名所有权验证失败

{
    "ResponseMetadata": {
        "RequestId": "20211215202125010225243125052DB635",
        "Action": "CheckRetrieveZone",
        "Version": "2018-08-01",
        "Service": "dns",
        "Region": "cn-north-1",
        "Error": {
            "CodeN": 600104,
            "Code": "CheckRetrieveZone",
            "Message": "type TXT record not found"
        }
    }
}