动态域名解析HTTP版-智能路由器API调用端口映射外网访问

官网最新动态

本文就动态域名解析HTTP版本的使用说明，确保智能路由器等设备API调用映射外网对内网端口的正常访问，解决公网IP不固定的问题。

动态域名解析http版说明：检测IP变化——更新协议及示例——返回代码参数说明

注：在nat123(网站或客户端)上添加动态域名解析记录后，才能使用HTTP调用。

一.检测IP变化

要确定客户端是否应该更新，它必须有一个可靠的方式来确定当前的IP地址是什么，以便比较最后一次更新的地址。以下有两种方式。

1.直接连接

客户端自行判断并获取其连接到互联网的公网IP地址。

2.网站IP检测

通过网站IP检测的方式，获取当前机器公网IP地址。

nat123 DDNS提供本地IP检测的服务，可通过下面地址检测: http://ddns.nat123.com

二.更新协议

当客户端发现IP地址变化或是用户修改设置时，客户端应该进行更新。
所有的更新都基本于标准的HTTP请求发送。
服务器会传回一个返回代码，客户端需要解析。

1.HTTP请求

请求支持HTTP协议，请求地址http://ddns.nat123.com/update.jsp

所有客户端必须发送一个完整的User-Agent文件头，用于区分不同的设备，空值或非法参数将导致请求失败。

2.例子

(1)使用URL验证
适用于浏览器或应用程序（fetch, curl, lwp-request），可以在URL中包含验证信息。

http://username:password@ddns.nat123.com/update.jsp?hostname=yourhostname&myip=ipaddress

(2)原始HTTP GET请求
实际的HTTP请求，类似下面的代码。
其中 base-64-authorization 请使用 Base64 加密 username:password 后的字符替换。

GET /update.jsp?hostname=yourhostname&myip=ipaddress HTTP/1.1

Host: ddns.nat123.com

Authorization: Basic base-64-authorization

User-Agent: nat123

请注意必须使用GET请求，POST是不被允许的。

(3)示例：

域名为my.123nat.com，ip由nat123自动获取，其它参数默认

http://ddns.nat123.com/update.jsp?hostname=my.123nat.com

(4)示例：

域名为my.123nat.com，并指定ip为1.2.3.4，电脑名或设备名为pcname，优先级为2，权重为4，正常解析

http://ddns.nat123.com/update.jsp?hostname=my.123nat.com&myip=1.2.3.4&computername=pcname&level=2&weight=4&offline=false

3.更新参数

允许提交以下参数：

序号	参数	说明
1	hostname	需要更新的域名，此域名必须是DNS/NS由nat123解析的域名。为空，则更新用户下所有动态域名。例：hostname=test.123nat.com,customtest.123nat.com
2	myip	需要更新的IP地址，可为空。如为空，则由服务器获取到的IP地址为准。
3	computername	计算机名，或设备名称
4	level	优先级。范围1-20，最大优先级是1。同一个域名存在多条相同解析记录时生效。优先级相同时负载均衡。
5	weight	权重。范围1-20，最大权重是20。优先级相同时生效。权重相同表示平均负载均衡，权重大的解析比例高。
6	offline	是否删除解析。值为true或false。 true表示删除动态域名。false表示正常解析。

三.返回代码

返回代码参数列表说明：

序号	参数	说明
1	good	更新成功，域名的IP地址已经更新，同时会返回本次更新成功的IP，用空格隔开，如：good 1.2.3.4
2	nochg	更新成功，但没有改变IP。一般这种情况为本次提交的IP跟上一次的一样
3	nohost	域名不存在。指未添加动态域名解析记录，或自主域名cname/dns/ns未指向nat123解析，或解析未生效。
4	badauth	用户名密码错误
5	abuse	请求失败，频繁请求或验证失败时会出现（10分钟内请求需小于20次，频繁请求将会封掉请求ip、帐号和域名）
6	servererror	系统错误