移动解析 HTTPDNS API 说明

一、概述

注意：说明：

二、前期准备

·开通移动解析 HTTPDNS 服务，详情请参见 开通移动解析 HTTPDNS 服务。

·在控制台添加需要解析的域名，详情请参见 添加域名。

·获取配置信息，详情请参见 配置信息说明。

三、接口描述

·接口请求地址：http://119.29.29.98/d? + {请求参数}。

·请求方式：POST 或 GET。

·入口 IP 的切换逻辑：当接入 IP 访问超时，或者返回的结果非 IP 格式，或者返回为空的时候，请采用其他入口 IP 接入，若所有 IP 均出现异常，请兜底至 LocalDNS 进行域名解析。

四、请求参数

注意：说明：

注意：ECS（EDNS-Client-Subnet）协议在 DNS 请求包中附加请求域名解析的用户 IP 地址，DNS 服务器可以根据该地址返回用户更快速访问的服务器 IP 地址。

五、请求说明

以 ID 为 xxx 为例。

六、请求 A 记录

·输入示例：

curl "http://119.29.29.98/d?dn={cloud.tencent.com 加密后字符串}&id=xxx"

·解密后返回格式：

2.3.3.4;2.3.3.5;2.3.3.6

·格式说明：返回查询结果，多个结果以 ';' 分隔。

七、返回结果中携带 ttl 信息

·输入示例：

curl "http://119.29.29.98/d?dn={cloud.tencent.com 加密后字符串}&id=xxx&ttl=1"

·解密后返回格式：

2.3.3.4;2.3.3.5;2.3.3.6,120

·格式说明：返回查询结果，多个结果以 ';' 分隔。记录值与 ttl 值以 ',' 分隔。

八、返回结果携带查询线路 IP 地址

·输入示例：

curl "http://119.29.29.98/d?dn={cloud.tencent.com 加密后字符串}&id=xxx&clientip=1&ip={DNS 请求的 ECS 值加密后字符串}&ttl=1"

·解密后返回格式：

12.3.3.4;2.3.3.5;2.3.3.6,120|1.2.3.4

·格式说明：返回结果中携带线路 ip 地址，以'|'分隔。如果没有传入 “ip=xxx” 参数，则返回出口 IP 地址；否则返回 ip 参数中的地址。

九、同时请求 A 和 AAAA 记录

·输入示例：

curl "http://119.29.29.98/d?dn={cloud.tencent.com 加密后字符串}&id=xxx&clientip=1&ip={DNS 请求的 ECS 值加密后字符串}&type=addrs&ttl=1"

·解密后返回格式：

2.3.3.4;2.3.3.5;2.3.3.6,120-2402:4e00:0123:4567:0::2345;2403:4e00:0123:4567:0::2346,120|1.2.3.4

·格式说明：A 记录和 AAAA 记录之间以 '-' 分隔，A 记录在前，AAAA 记录在后。

十、返回结果中携带被查询域名

·输入示例：

curl "http://119.29.29.98/d?dn={cloud.tencent.com 加密后字符串}&id=xxx&clientip=1&ip={DNS 请求的 ECS 值加密后字符串}&query=1&ttl=1"

·解密后返回格式：

cloud.tencent.com.:2.3.3.4;2.3.3.5;2.3.3.6,120|1.2.3.4

·格式说明：返回格式为 “域名.:结果” 的格式。

十一、批量域名请求

·输入示例：

curl "http://119.29.29.98/d?dn={cloud.tencent.com,www.qq.com,www.dnspod.cn 加密后字符串}&id=xxx&clientip=1&ip={DNS 请求的 ECS 值加密后字符串}&ttl=1"

·解密后返回格式：

cloud.tencent.com.:2.3.3.4;2.3.3.5;2.3.3.6,120|1.2.3.4www.qq.com.:3.3.3.4;3.3.3.5;3.3.3.6,180|1.2.3.4www.dnspod.cn.:4.3.3.4;4.3.3.5;4.3.3.6,60|1.2.3.4

·格式说明：多个域名返回内容之间以 “换行符” 分隔，ip 地址附加在所有记录值的最后。

十二、POST 方法请求 A 记录

·输入示例：

curl "http://119.29.29.98/d" -d "dn={cloud.tencent.com 加密后字符串}&id=xxx" -X POST

·解密后返回格式：

2.3.3.4;2.3.3.5;2.3.3.6

·格式说明：返回查询结果，多个结果以 ';' 分隔。

十三、查询 A 记录

·输入示例：

curl "http://119.29.29.98/d?dn={cloud.tencent.com 加密后字符串}&id=xxx"

·解密后返回格式：空字符串或者0。

·格式说明： 没有记录，则返回0。未在控制台添加主域名，返回 HTTP 状态码401和空字符。

十四、返回结果中包含域名

·输入示例：

curl "http://119.29.29.98/d?dn={cloud.tencent.com 加密后字符串}&id=xxx&query=1&ip={DNS 请求的 ECS 值加密后字符串}&clientip=1"

·解密后返回格式：

cloud.tencent.com.:0|1.2.3.4

·格式说明：0表示没有记录。

十五、返回 A 与 AAAA 的记录

·输入示例：

curl "http://119.29.29.98/d?dn={cloud.tencent.com 加密后字符串}&id=xxx&type=addrs&query=1&ip={DNS 请求的 ECS 值加密后字符串}&clientip=1"

·解密后返回格式：

cloud.tencent.com.:0-0|1.2.3.4

·格式说明：0表示没有记录。如果某个记录存在，则该记录正常返回在结果中，例如 cloud.tencent.com.:2.3.4.5;3.3.3.3-0|1.2.3.4，表示 AAAA 记录无法查询到。

十六、批量域名请求

·输入示例：

curl "http://119.29.29.98/d?dn={cloud.tencent.com,www.qq.com,www.dnspod.cn 加密后字符串}&id=xxx&clientip=1&ip={DNS 请求的 ECS 值加密后字符串}&ttl=1"

·解密返回格式：

cloud.tencent.com.:0,0|1.2.3.4www.qq.com.:3.3.3.4;3.3.3.5;3.3.3.6,180|1.2.3.4www.dnspod.cn.:4.3.3.4;4.3.3.5;4.3.3.6,60|1.2.3.4

·格式说明：未查询到数据的域名则返回0。如果某个记录存在，则该记录正常返回在结果中。

十七、HTTP 状态码

以下为接口业务逻辑相关的 HTTP 状态码。