点击免费下载88ip集成协议>>
(下面的协议作为word形式给用户下载)

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）格式：
<?xml version="1.0"?>
<ELinkPacket>
<MsgType>ActiveTestReq</MsgType>
<Version>1.0</Version>
<UserName>[username data]</UserName>
<UserPwd>[userpwd data]</UserPwd>
</ELinkPacket>

Sample:
<?xml version="1.0"?>
<ELinkPacket>
<MsgType>ActiveTestReq</MsgType>
<Version>1.0</Version>
<UserName>kenny</UserName>
<UserPwd>123654</UserPwd>
</ELinkPacket>
3、参数说明
username为88IP用户的用户名
   userpwd为88IP用户的用户密码
4、数据包提交地址
 http://link.dipserver.com/elink/elink.dll/

5、数据返回
系统将返回一个xml数据包
<?xml version="1.0"?>
<ELinkPacket>
<MsgType>ActiveTestResp</MsgType>
<Version>1.0</Version>
<Result>0</Result>
<UserIP>218.18.44.36</UserIP>
</ELinkPacket>

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：
 http://user.dipns.com/api/？userid=[userid data]&userpwd=[password data]
sample:
 http://user.dipns.com/api/?userid=19770702&userpwd=123654
B、由硬件获得IP，或由用户指定IP，按下列格式提交到88IP服务器，88IP服务器将把域名解析到此IP上：
 http://user.dipns.com/api/ipaddress.asp?userid=[userid data]&userpwd=[password data]
&ipaddress=[ipaddress data]
Sample:
 http://user.dipns.com/api/ipaddress.asp?userid=19770702&userpwd=123654&ipaddress=219.238.232.175
（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动态ｉｐ域名解析服务的帮助信息。为了让需要这项功能的用户很好地使用这一增值服务，请厂商在集成协议的时候，根据实际应用情况，为用户提供必要的帮助信息，如在硬件说明书中描述８８ＩＰ的功能和用法，在配置界面里提供引导和帮助，在提供给用户的电子文档里携带具体的用法演示等。