88IP动态IP域名解析服务集成规范
88IP 动态IP 域名解析服务集成规范一、适用硬件能接入互联网并能向Internet 上的88IP 服务器发送HTTP 请求的各种硬件，包括路由器、VOIP 设备、视频服务器、防火墙等。二、服务的获
88IP 动态IP 域名解析服务集成规范
一、适用硬件
能接入互联网并能向Internet 上的88IP 服务器发送HTTP 请求的各种硬件，包括路由器、VOIP 设备、视频服务器、防火墙等。
二、服务的获得
1，登录88IP 官方网站，试用/定购服务： 网址http://www.88ip.cn
获得用户ID 和密码后，才可以使用88IP 的动态IP 域名解析服务。
2，从88IP 合作伙伴获取：
88IP 提供了标准的服务注册接口给各合作伙伴，从88ip 有效合作伙伴获得的服务，和从88IP 官方获得的服务等效。
同时，欢迎硬件厂商、集成商和88IP 进行商务合作，为硬件用户提供更好的服务。
三、域名规范
1、独立的域名必须由88IP 的DNS 解析，88IP 的DNS 服务器：
服务器1：ns1.dipns.com
服务器2：ns1.dipserver.com
服务器3：ns2.dipns.com
服务器4：ns2.dipserver.com
注：在88IP 官方网站注册的独立域名默认使用的都是88IP 的DNS 服务器，
2、用户可以使用88IP 提供的域名根（如88IP.CN,88IP.COM ）做后缀, 使用免费的域名。目前88IP 提供的域名根有：88ip.cn;88ip.com;88ip.net;dipns.com;dipns.net;ip88.net 。
3、用户也可以使用88IP 合作伙伴提供的域名根做后缀，使用其下级域名。
但要求作为域名根的域名，必须由88IP 的DNS 服务器解析，并通过88IP 的系统认可。
4、目前88ip 提供的独立域名根包括：
.com;.net;.org;.gov;.edu;.com.cn;.net.cn;.gov.cn;.edu.cn;.org.cn;.cn;.tv;.info;.biz;.cc等；
对于需要新增的独立域名根，如（.com.tw;.com.jp ）等，可以由合作伙伴或用户提请88IP 加入到系统中。
四、配置88IP 账户到硬件设备中
1、浏览器配置方式举例
目前很多硬件的配置都是通过浏览器进行的，下面是个例子，用户ID 和密码是由第二章介绍的途径获得，其中“申请新用户”则链接到88IP 官方网站的注册页面或88IP 合作伙伴的注册页面。
,
2、telnet 配置方式举例
root/set userid=19770702
root/set userpwd=123654
五、硬件IP 更新协议
（一）、XML （推荐使用）
更新域名的ip 是通过硬件按一定频率提交XML 数据包请求到88IP 服务器接口来完成的。
1、更新频率应控制在每1分钟提交(post)XML数据包请求一次到88IP 服务器接口。
2、 更新IP （update ip）的方法，采用xml 数据包提交数据请求
XML 数据包（ActiveTestReq.xml ）格式：
Sample:
3、参数说明
,username 为88IP 用户的用户名
userpwd为88IP 用户的用户密码
4、数据包提交地址
5、数据返回
系统将返回一个xml 数据包
6、数据返回说明
在HTTP 通信时的状态码请参见HTTP/1.1协议中规定的状态码值，不包含在本规范的返回值统一定义中。 返回结果（Result ）具体描述如下：
0 ： 成功
1 ： 未知错误
100 ：用户不存在
102 ：用户密码错误
110 ：用户类型错误
（二）、HTTP
更新域名的ip 是通过硬件按一定频率提交HTTP 请求到88IP 服务器接口来完成的。
2、 更新频率应控制在每1-10分钟提交HTTP 请求一次请求到88IP 服务器接口。
3、 更新IP （update ip）的方法有两种：
A 、按下列格式发送请求，由88IP 解析服务器从HTTP 请求数据包自动提取公网IP 更新到DNS ：
sample:
B 、由硬件获得IP ，或由用户指定IP ，按下列格式提交到88IP 服务器，88IP 服务器将把域名解析到此IP 上：
Sample:
（ipadrress 为硬件自动获取或用户指定的IP 地址。）
3、参数返回
把以上协议提交到88IP 服务器后，从88IP 服务器接口返回的数据有以下几个类型：
,A 、 parameter format illegal!
B 、 user not exist!
C 、 password error!
D 、 user expired!
E 、 host now points to xxx.xxx.xxx.xxx (Sample: host now points to 219.238.232.175) 当得到Ｅ项返回值，即表示更新成功。
六、相关事项
１、 不得将协议中88IP 接口地址：link.dipserver.com 或user.dipns.com 直接换成ＩＰ地址写入硬件中，而必须是在使用过程中由ＤＮＳ解析获得。因为88ip 服务器接口地址是由多个ＩＰ地址提供，而且ＩＰ地址也可能因８８ＩＰ系统升级和迁移而发生变化。
２、 硬件接入ＩＮＴＥＲＮＥＴ的ＤＮＳ服务器必须能让用户修改。随机从ＩＳＰ获取的ＤＮＳ经常有实效的现象，如果用户不能更改这个ＤＮＳ，将硬件无法通过域名方式访问internet, 也就无法将ＩＰ更新请求提交到８８ＩＰ服务器。所以请广大系统开发商务必为用户提供修改硬件ＤＮＳ服务器地址的功能。 ３、 在硬件相关资料上为用户提供使用88ip 动态ｉｐ域名解析服务的帮助信息。为了让需要这项功能的用户很好地使用这一增值服务，请厂商在集成协议的时候，根据实际应用情况，为用户提供必要的帮助信息，如在硬件说明书中描述８８ＩＰ的功能和用法，在配置界面里提供引导和帮助，在提供给用户的电子文档里携带具体的用法演示等。