动态域名解析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.na ... &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.js ... 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

系统错误