免费版 API 接入

最近更新时间:2019-10-08 16:21:51

根据域名和用户 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。
以下列请求为例:

http://119.29.29.29/d?dn=www.dnspod.cn.&ip=1.1.1.1

返回

183.60.57.155

返回值一

域名不存在

如果域名不存在,HttpDNS 无法查询到最终的IP指向,则返回空。
以下列请求为例:

http://119.29.29.29/d?dn=www.dnspod2.cn.&ip=1.1.1.1

返回空字符串,如下图所示:
返回值二

根据域名和用户 IP 查询带 TTL 的结果

数据请求和应答均使用 HTTP 协议。
请求格式为:

http://119.29.29.29/d?dn=www.dnspod.cn.&ip=1.1.1.1&ttl=1

ttl = 1 表示要求返回结果携带解析结果的 TTL 值。
返回的 TTL 和域名解析结果用英文逗号分隔。

以下列请求为例,表示要求返回结果带上 TTL:

http://119.29.29.29/d?dn=www.dnspod.cn.&ip=1.1.1.1&ttl=1

返回值如下,表示递归服务器缓存的 TTL 是 60 秒:

183.60.57.155,60

返回值三

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

数据请求和应答均使用 HTTP 协议。
请求格式为:

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

以下列请求为例,表示要求返回结果带上解析地址以及用户公网出口 IP。

http://119.29.29.29/d?dn=www.dnspod.cn&clientip=1

返回值如下,表示解析地址为113.96.208.81,用户出口 IP 为14.17.22.47。

113.96.208.81|14.17.22.47