88IP動態(tài)IP域名解析服務(wù)集成規(guī)范
88IP 動態(tài)IP 域名解析服務(wù)集成規(guī)范一、適用硬件能接入互聯(lián)網(wǎng)并能向Internet 上的88IP 服務(wù)器發(fā)送HTTP 請求的各種硬件,包括路由器、VOIP 設(shè)備、視頻服務(wù)器、防火墻等。二、服務(wù)的獲
88IP 動態(tài)IP 域名解析服務(wù)集成規(guī)范
一、適用硬件
能接入互聯(lián)網(wǎng)并能向Internet 上的88IP 服務(wù)器發(fā)送HTTP 請求的各種硬件,包括路由器、VOIP 設(shè)備、視頻服務(wù)器、防火墻等。
二、服務(wù)的獲得
1,登錄88IP 官方網(wǎng)站,試用/定購服務(wù): 網(wǎng)址http://www.88ip.cn
獲得用戶ID 和密碼后,才可以使用88IP 的動態(tài)IP 域名解析服務(wù)。
2,從88IP 合作伙伴獲?。?/p>
88IP 提供了標(biāo)準(zhǔn)的服務(wù)注冊接口給各合作伙伴,從88ip 有效合作伙伴獲得的服務(wù),和從88IP 官方獲得的服務(wù)等效。
同時,歡迎硬件廠商、集成商和88IP 進(jìn)行商務(wù)合作,為硬件用戶提供更好的服務(wù)。
三、域名規(guī)范
1、獨立的域名必須由88IP 的DNS 解析,88IP 的DNS 服務(wù)器:
服務(wù)器1:ns1.dipns.com
服務(wù)器2:ns1.dipserver.com
服務(wù)器3:ns2.dipns.com
服務(wù)器4:ns2.dipserver.com
注:在88IP 官方網(wǎng)站注冊的獨立域名默認(rèn)使用的都是88IP 的DNS 服務(wù)器,
2、用戶可以使用88IP 提供的域名根(如88IP.CN,88IP.COM )做后綴, 使用免費的域名。目前88IP 提供的域名根有:88ip.cn;88ip.com;88ip.net;dipns.com;dipns.net;ip88.net 。
3、用戶也可以使用88IP 合作伙伴提供的域名根做后綴,使用其下級域名。
但要求作為域名根的域名,必須由88IP 的DNS 服務(wù)器解析,并通過88IP 的系統(tǒng)認(rèn)可。
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 加入到系統(tǒng)中。
四、配置88IP 賬戶到硬件設(shè)備中
1、瀏覽器配置方式舉例
目前很多硬件的配置都是通過瀏覽器進(jìn)行的,下面是個例子,用戶ID 和密碼是由第二章介紹的途徑獲得,其中“申請新用戶”則鏈接到88IP 官方網(wǎng)站的注冊頁面或88IP 合作伙伴的注冊頁面。
,2、telnet 配置方式舉例
root/set userid=19770702
root/set userpwd=123654
五、硬件IP 更新協(xié)議
(一)、XML (推薦使用)
更新域名的ip 是通過硬件按一定頻率提交XML 數(shù)據(jù)包請求到88IP 服務(wù)器接口來完成的。
1、更新頻率應(yīng)控制在每1分鐘提交(post)XML數(shù)據(jù)包請求一次到88IP 服務(wù)器接口。
2、 更新IP (update ip)的方法,采用xml 數(shù)據(jù)包提交數(shù)據(jù)請求
XML 數(shù)據(jù)包(ActiveTestReq.xml )格式:
Sample:
3、參數(shù)說明
,username 為88IP 用戶的用戶名
userpwd為88IP 用戶的用戶密碼
4、數(shù)據(jù)包提交地址
5、數(shù)據(jù)返回
系統(tǒng)將返回一個xml 數(shù)據(jù)包
6、數(shù)據(jù)返回說明
在HTTP 通信時的狀態(tài)碼請參見HTTP/1.1協(xié)議中規(guī)定的狀態(tài)碼值,不包含在本規(guī)范的返回值統(tǒng)一定義中。 返回結(jié)果(Result )具體描述如下:
0 : 成功
1 : 未知錯誤
100 :用戶不存在
102 :用戶密碼錯誤
110 :用戶類型錯誤
(二)、HTTP
更新域名的ip 是通過硬件按一定頻率提交HTTP 請求到88IP 服務(wù)器接口來完成的。
2、 更新頻率應(yīng)控制在每1-10分鐘提交HTTP 請求一次請求到88IP 服務(wù)器接口。
3、 更新IP (update ip)的方法有兩種:
A 、按下列格式發(fā)送請求,由88IP 解析服務(wù)器從HTTP 請求數(shù)據(jù)包自動提取公網(wǎng)IP 更新到DNS :
sample:
B 、由硬件獲得IP ,或由用戶指定IP ,按下列格式提交到88IP 服務(wù)器,88IP 服務(wù)器將把域名解析到此IP 上:
Sample:
(ipadrress 為硬件自動獲取或用戶指定的IP 地址。)
3、參數(shù)返回
把以上協(xié)議提交到88IP 服務(wù)器后,從88IP 服務(wù)器接口返回的數(shù)據(jù)有以下幾個類型:
,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) 當(dāng)?shù)玫剑彭椃祷刂?,即表示更新成功?/p>
六、相關(guān)事項
1、 不得將協(xié)議中88IP 接口地址:link.dipserver.com 或user.dipns.com 直接換成IP地址寫入硬件中,而必須是在使用過程中由DNS解析獲得。因為88ip 服務(wù)器接口地址是由多個IP地址提供,而且IP地址也可能因88IP系統(tǒng)升級和遷移而發(fā)生變化。
2、 硬件接入INTERNET的DNS服務(wù)器必須能讓用戶修改。隨機(jī)從ISP獲取的DNS經(jīng)常有實效的現(xiàn)象,如果用戶不能更改這個DNS,將硬件無法通過域名方式訪問internet, 也就無法將IP更新請求提交到88IP服務(wù)器。所以請廣大系統(tǒng)開發(fā)商務(wù)必為用戶提供修改硬件DNS服務(wù)器地址的功能。 3、 在硬件相關(guān)資料上為用戶提供使用88ip 動態(tài)ip域名解析服務(wù)的幫助信息。為了讓需要這項功能的用戶很好地使用這一增值服務(wù),請廠商在集成協(xié)議的時候,根據(jù)實際應(yīng)用情況,為用戶提供必要的幫助信息,如在硬件說明書中描述88IP的功能和用法,在配置界面里提供引導(dǎo)和幫助,在提供給用戶的電子文檔里攜帶具體的用法演示等。