免费版 API 接入

最近更新时间:2020-09-17 10:44:46

免费 API 接入可完成使用域名和用户 IP 的相关查询,相关示例如下:

场景1:根据域名及用户 IP 查询

根据域名和用户 IP 查询解析记录中域名指向的 IP,数据请求和应答均使用 HTTP 协议。

输入示例

http://119.29.29.29/d?dn=www.dnspod.cn.&ip=1.1.1.1
  • dn 表示要查询的域名。
  • ip 表示用户 IP,当 ip 为内网 IP 或非法 IP,默认取 HTTP 报文的源 IP 为用户 IP,此时 HTTPDNS 会按照用户设置的默认线路进行解析。

输出示例

  • 域名存在:如果 HTTPDNS 能查询到最终的 IP 指向,则直接返回 IP。输出示例如下:
    183.60.57.155
    返回值一
  • 域名不存在:如果域名不存在,HTTPDNS 无法查询到最终的 IP 指向,则返回空。输出示例如下:
    返回值二

场景2:根据域名和用户 IP 查询带 TTL 的结果

根据域名和用户 IP 查询带 TTL 的结果,数据请求和应答均使用 HTTP 协议。

输入示例

http://119.29.29.29/d?dn=www.dnspod.cn.&ip=1.1.1.1&ttl=1
  • ttl = 1 表示要求返回结果携带解析结果的 TTL 值。
  • 返回的 TTL 和域名解析结果用英文逗号分隔。

输出示例

183.60.57.155,60
说明:

表示递归服务器缓存的 TTL 是 60 秒。

返回值三

场景3:根据域名查询解析地址及用户公网出口 IP

根据域名查询解析地址及用户公网出口 IP,数据请求和应答均使用 HTTP 协议。

输入示例

http://119.29.29.29/d?dn=www.dnspod.cn&clientip=1
  • clientip=1 表示返回用户的出口 IP。
  • 返回结果包括 www.dnspod.cn 的解析地址以及用户公网出口 IP,二者用|分隔。

输出示例

113.96.208.81|14.17.22.47
说明:

  • 解析地址为 113.96.208.81
  • 用户出口 IP 为 14.17.22.47

场景4:根据域名查询 IPv6 地址

根据域名查询 IPv6 地址,数据请求和应答均使用 HTTP 协议。

输入示例

http://119.29.29.29/d?dn=www.qq.com&type=AAAA

其中,type=AAAA 表示要求返回域名解析结果的 IPv6 地址。

输出示例

40e:ff:f101:10::15f;240e:ff:f101:10::14d
说明:

要查询的域名需支持 IPv6,否则返回为空。

目录