tencent cloud

概述

移动解析 HTTPDNS 通过 HTTP/HTTPS 接口对外提供域名解析服务，服务接入直接使用 IP 地址，服务 IP 有多个，移动解析 HTTPDNS 的 HTTP 请求方式查询入口以 43.132.55.55 为例。

说明：

• 当前仅开放了DES加密方式（服务IP： 43.132.55.55），HTTPS、AES加密方式未开放。
• 开通移动解析 HTTPDNS 服务 后，您需在移动解析 HTTPDNS 控制台添加解析域名后才可正常使用。详情请参见 添加域名。
• 我们提供2个入口 IP 示例，HTTP 协议的服务 IP：43.132.55.55，HTTPS 协议的服务 IP：43.132.55.56。
• 请优先使用官方 SDK，如果场景特殊下无法使用 SDK，需要直接访问 HTTP API 接口，请 提交工单 联系我们，我们将根据您的具体使用场景，为您提供多个服务 IP 和相关的安全建议。
• 考虑到服务 IP 防攻击之类的安全风险，为保障服务可用性，HTTPDNS 同时提供多个服务 IP，当某个服务 IP 在异常情况下不可用时，可以使用其它服务 IP 进行重试。

前期准备

使用请求接口 http://43.132.55.55/d?+{请求参数}时，需使用以下配置信息。请前往移动解析 HTTPDNS 管理控制台开发配置页获取相关配置信息：

• 授权 ID：使⽤移动解析 HTTPDNS 服务中，开发配置的唯⼀标识。调⽤移动解析 HTTPDNS 的 HTTP 解析接口 http://43.132.55.55 时中传⼊的授权 ID 参数。
• DES 加密密钥：调⽤移动解析 HTTPDNS 的 HTTP 解析接口 http://43.132.55.55 并使用 DES 加密方式时，对 DNS 请求数据进⾏加密时的加密密钥。
• AES 加密密钥：调⽤移动解析 HTTPDNS 的 HTTP 解析接口 http://43.132.55.55 并使用 AES 加密方式时，对 DNS 请求数据进⾏加密时的加密密钥。

接口描述

• 接口请求地址：http://43.132.55.55/d? + {请求参数}。
• 请求方式：POST 或 GET。
• 考虑到服务 IP 防攻击之类的安全风险，为保障服务可用性，我们同时提供多个服务 IP，如您直接通过 API 接口请求 HTTPDNS 服务，请 提交工单 联系我们，我们将根据您的具体使用场景，为您提供多个服务 IP 和相关的安全建议。
• 入口 IP 的切换逻辑：当接入 IP 访问超时，或者返回的结果非 IP 格式，或者返回为空的时候，请采用其他入口 IP 接入，若所有 IP 均出现异常，请兜底至 LocalDNS 进行域名解析。

请求参数

参数名	参数含义	是否必选	取值	加密	说明
dn	被查询的域名	是	加密前的单个域名长度为253	是	需在移动解析 HTTPDNS 控制台已添加域名并且为传输加密后的字符串。 域名添加请参见 添加域名。 加密详情请参见 加密与解密算法使用说明。
id	用户标识	是	1 - 10000	否	如果使用 AES、DES 加密方式，必须传入 ID，不需要进行加密。
alg	选择使用何种算法	是	[aes/des]	否	默认使用 DES 算法，不同算法具有不同密钥。
ip	DNS 请求的 ECS（EDNS-Client-Subnet）值	否	IPv4/IPv6 地址值	是	默认情况下 HTTPDNS 服务器会查询客户端出口 IP 为 DNS 线路查询 IP，使用 “ip=xxx” 参数，可以指定线路 IP 地址。支持 IPv4/IPv6 地址传入，接口会自动识别。加密详情请参见 加密与解密算法使用说明。
query	结果中返回被查询域名	否	1	否	单域名查询情况下，此参数要求返回结果中携带被查询域名。
timeout	超时返回时间	否	1000 - 5000，单位为毫秒	否	可用值[1000, 5000]，单位为ms，查询超时时间，默认值为5秒。
ttl	查询结果是否返回 TTL 值	否	1	否	可用值 [1]，不携带此参数，默认为不传递TTL值。
type	查询类型	否	[aaaa/AAAA/addrs/ADDRS]	否	可用值[aaaa,AAAA,addrs,ADDRS]。默认查询 A 记录，设置 AAAA/aaaa 查询 AAAA 记录，设置 addrs/ADDRS 同时查询 A 和 AAAA 记录。
clientip	查询结果中返回的客户端 IP 地址	否	1	否	可用值 [1]，不携带此参数，默认为不传递 clientip 值。若此参数取值，则返回结果中地址值在 | 符号后，若携带有 ip 参数，返回的是 ip 参数的值，否则返回客户端地址 IP。

说明：

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

请求说明

以 ID 为 xxx 为例。

注意：

• 以下示例为 AES/DES 加密方式，其中域名和 IP 参数均需要加密，例如，域名为 cloud.tencent.com 需要进行加密，授权 ID 不需要进行加密。
• 若 HTTPDNS 未查询到解析结果，将返回为空值。
• HTTP 已接入 BGP Anycast，并实现多地机房容灾，但为了服务质量更高的保障，建议您采用 Failed over 策略 进行接入。

请求 A 记录

• 输入示例：

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

• 解密后返回格式：

  2.3.3.4;2.3.3.5;2.3.3.6
  

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

返回结果中携带 ttl 信息

• 输入示例：

  curl "http://43.132.55.55/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://43.132.55.55/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://43.132.55.55/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://43.132.55.55/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://43.132.55.55/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
  www.qq.com.:3.3.3.4;3.3.3.5;3.3.3.6,180
  www.dnspod.cn.:4.3.3.4;4.3.3.5;4.3.3.6,60|1.2.3.4
  

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

请求异常或无记录说明

注意：

• 以下示例为 AES/DES 加密方式，其中域名和 IP 参数均需要加密，例如域名为 cloud.tencent.com 需要加密，授权 ID 不需要进行加密。
• 如使用 HTTPS 加密方式，请求地址改为 43.132.55.56 并且必须要传入 token。

查询 A 记录

• 输入示例：

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

• 解密后返回格式： 空。

• 格式说明： 没有记录，则返回空字符串。

返回结果中包含域名

• 输入示例：

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

• 解密后返回格式：

  cloud.tencent.com|1.2.3.4
  

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

返回 A 与 AAAA 的记录

• 输入示例：

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

• 解密后返回格式：

  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://43.132.55.55/d?dn={cloud.tencent.com,www.qq.com,www.dnspod.cn 加密后字符串}&id=xxx&clientip=1&ip={DNS 请求的 ECS 值加密后字符串}&ttl=1"
  
  

• 解密返回格式：

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

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

HTTP 状态码

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

状态码	描述
200 OK	如果接口调用正确，无论是否查询成功，均返回状态码200。
404 Not Found	接口不存在或 URL 实际上访问了某不存在的资源。
429 Too Many Request	访问过于频繁，超过了服务器限制。
501 Not Implemented	使用了非 “GET” 或 “POST” 请求方式。