验证域名解析¶
1. 接口描述¶
接口请求路径：GET /prod-api/acdn/tcdn/domainRest/verifyDomainRecord
verifyDomainRecord 用于校验加速域名的归属权。请先调用 创建域名验证记录，按返回内容完成 DNS TXT 或文件配置后再调用。账号需具备 tcdn:CreateDomain 权限。
Token 获取方式见 密钥鉴权。
注意：
data.verifyResponse.result为true表示归属权已通过，为false表示尚未通过。两种结果的code都是200。- 验证通过后不会自动创建加速域名，请再次调用 创建域名。
2. 输入参数¶
以下请求参数列表仅列出了接口请求参数和部分公共参数，完整公共参数列表见 公共请求参数。
| 参数名称 | 必选 | 类型 | 描述 |
|---|---|---|---|
| domain | 是 | String | Query 参数。待验证的加速域名，与创建验证记录时一致。示例值：www.example.com |
| verifyType | 是 | String | Query 参数。验证方式。取值：dns（DNS 解析验证）、file（文件验证）。示例值：dns |
3. 输出参数¶
| 参数名称 | 类型 | 描述 |
|---|---|---|
| code | Integer | 状态码。示例值：200 |
| msg | String | 提示信息。示例值：成功 |
| data | Object | 验证结果 |
| data.verifyResponse | VerifyResponse | 归属权是否验证通过 |
4. 示例¶
示例1 DNS 解析验证通过¶
输入示例¶
代码调用¶
请将 {登录域名}、token 替换为实际值。
import org.apache.http.client.methods.CloseableHttpResponse;
import org.apache.http.client.methods.HttpGet;
import org.apache.http.client.utils.URIBuilder;
import org.apache.http.impl.client.CloseableHttpClient;
import org.apache.http.impl.client.HttpClients;
import org.apache.http.util.EntityUtils;
public class VerifyDomainRecordTest {
public static void main(String[] args) throws Exception {
String token = "eyJhbGciOiJIUzUxMiJ9.xxxxxx";
URIBuilder uriBuilder = new URIBuilder("https://{登录域名}/prod-api/acdn/tcdn/domainRest/verifyDomainRecord");
uriBuilder.addParameter("domain", "www.example.com");
uriBuilder.addParameter("verifyType", "dns");
try (CloseableHttpClient httpClient = HttpClients.createDefault()) {
HttpGet httpGet = new HttpGet(uriBuilder.build());
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"
"net/url"
)
func main() {
token := "eyJhbGciOiJIUzUxMiJ9.xxxxxx"
u, err := url.Parse("https://{登录域名}/prod-api/acdn/tcdn/domainRest/verifyDomainRecord")
if err != nil {
panic(err)
}
q := u.Query()
q.Set("domain", "www.example.com")
q.Set("verifyType", "dns")
u.RawQuery = q.Encode()
req, err := http.NewRequest(http.MethodGet, u.String(), 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": {
"verifyResponse": {
"result": true,
"requestId": "a1b2c3d4-e5f6-7890-abcd-ef1234567890"
}
}
}
示例2 DNS 解析尚未通过¶
TXT 记录未生效时，接口仍返回成功，result 为 false。请确认解析后再重试。文件验证将 verifyType 改为 file，请求和响应结构相同。
输入示例¶
代码调用¶
请将 {登录域名}、token 替换为实际值。
import org.apache.http.client.methods.CloseableHttpResponse;
import org.apache.http.client.methods.HttpGet;
import org.apache.http.client.utils.URIBuilder;
import org.apache.http.impl.client.CloseableHttpClient;
import org.apache.http.impl.client.HttpClients;
import org.apache.http.util.EntityUtils;
public class VerifyDomainRecordTest {
public static void main(String[] args) throws Exception {
String token = "eyJhbGciOiJIUzUxMiJ9.xxxxxx";
URIBuilder uriBuilder = new URIBuilder("https://{登录域名}/prod-api/acdn/tcdn/domainRest/verifyDomainRecord");
uriBuilder.addParameter("domain", "www.example.com");
uriBuilder.addParameter("verifyType", "dns");
try (CloseableHttpClient httpClient = HttpClients.createDefault()) {
HttpGet httpGet = new HttpGet(uriBuilder.build());
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"
"net/url"
)
func main() {
token := "eyJhbGciOiJIUzUxMiJ9.xxxxxx"
u, err := url.Parse("https://{登录域名}/prod-api/acdn/tcdn/domainRest/verifyDomainRecord")
if err != nil {
panic(err)
}
q := u.Query()
q.Set("domain", "www.example.com")
q.Set("verifyType", "dns")
u.RawQuery = q.Encode()
req, err := http.NewRequest(http.MethodGet, u.String(), 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": {
"verifyResponse": {
"result": false,
"requestId": "a1b2c3d4-e5f6-7890-abcd-ef1234567890"
}
}
}
5. 错误码¶
上游调用失败时，code 为 500，原因在 msg，没有 data。解析未生效时不会走该错误，而是 code 为 200 且 data.verifyResponse.result 为 false。
| HTTP 状态码 / 业务提示 | 描述 |
|---|---|
| 200 | 请求已返回。是否通过以 data.verifyResponse.result 为准 |
| 401 | 未鉴权或 Token 无效 |
| 403 | 无权限，需具备 tcdn:CreateDomain |
| 缺少必填参数：domain | 未传 Query 参数 domain |
| 缺少必填参数：verifyType | 未传 Query 参数 verifyType |
| error code:{0},message:{1} | 上游验证失败。{0} 为错误码，{1} 为原因 |
6. 数据模型¶
VerifyResponse¶
归属权验证结果。
| 参数名称 | 类型 | 描述 |
|---|---|---|
| result | Boolean | 是否验证通过。true 表示通过，false 表示未通过。示例值：true |
| requestId | String | 唯一请求 ID。示例值：a1b2c3d4-e5f6-7890-abcd-ef1234567890 |