中國萬網(wǎng)域名主機郵箱API接口_V2.0.3(20150115最新)
中國萬網(wǎng)域名、虛擬主機、企業(yè)郵局A P I 接口說明文檔作 者: HiChina發(fā)行日期：2014/10/13第 1 頁 共 60 頁 ,中國萬網(wǎng)域名API 接口說明
中國萬網(wǎng)
域名、虛擬主機、企業(yè)郵局
A P I 接口說明文檔
作 者: HiChina
發(fā)行日期：2014/10/13
第 1 頁 共 60 頁
,中國萬網(wǎng)域名API 接口說明文檔
前言
本文檔描述了中國萬網(wǎng)域名注冊，虛擬主機，企業(yè)郵局API 接口協(xié)議。本文檔描述了基本的數(shù)據(jù)交換標(biāo)準(zhǔn)，其中包括數(shù)據(jù)格式，數(shù)據(jù)定義，以及一些相關(guān)約定。
目錄
1．API 接口地址 . ............................................................................................................................ 4
2．參數(shù)說明..................................................................................................................................... 4
2．1公共參數(shù) . ................................................................................................................................ 4
2．2行為參數(shù)（ACTION ） ............................................................................................................ 5
2.2.1域名類 . ................................................................................................................................ 5
2.2.1.1域名注冊 . ..................................................................................................................... 5
2.2.1.2修改聯(lián)系人 . ................................................................................................................. 8
2.2.1.3域名續(xù)費 . ................................................................................................................... 10
2.2.1.4注冊主機(創(chuàng)建域名服務(wù)器) ..................................................................................... 10
2.2.1.5修改解析服務(wù)器(域名DNS 修改) ........................................................................... 10
2.2.1.6修改域名密碼 . ........................................................................................................... 11
2.2.1.7修改主機IP(修改域名服務(wù)器IP) ............................................................................ 11
2.2.1.9域名解析 . ................................................................................................................... 11
2.2.1.9.1 顯示域名當(dāng)前解析記錄 . ................................................................................... 11
2.2.1.9.2 增加域名解析記錄 . ........................................................................................... 12
2.2.1.9.3 刪除域名解析記錄 . ........................................................................................... 13
2.2.1.9.4 修改域名解析記錄 . ........................................................................................... 14
2.2.1.9.5 購買解析記錄條數(shù) . ........................................................................................... 14
2.2.1.10 顯示域名信息 . ........................................................................................................ 14
2.2.1.11 參數(shù)限制 . ................................................................................................................ 16
2.2.1.11.1 Cn域名以及國內(nèi)中文域名 ............................................................................. 16
2.2.2 虛擬主機類 . ..................................................................................................................... 16
2.2.2.1 虛擬主機購買 . .......................................................................................................... 16
2.2.2.2 虛擬主機續(xù)費 . .......................................................................................................... 22
2.2.2.3 虛擬主機升級 . .......................................................................................................... 22
2.2.2.4 虛擬主機管理 . .......................................................................................................... 23
2.2.2.4.1主機增加空間 . .................................................................................................... 23
2.2.2.4.2修改操作系統(tǒng) . .................................................................................................... 24
2.2.2.4.3修改主機管理密碼(FTP密碼) .......................................................................... 25
2.2.2.4.4修改機房 . ............................................................................................................ 25
2.2.2.4.5修改主機域名 . .................................................................................................... 25 Document No.: 001 第 2 頁 共 60頁 VER: 1.0
,中國萬網(wǎng)域名API 接口說明文檔
2.2.2.4.6顯示主機信息 . .................................................................................................... 26
2.2.2.4.7 綁定主機域名 . ................................................................................................... 26
2.2.2.5 翔云主機購買(新購已下線，只能續(xù)費) ................................................................ 27
2.2.3郵箱類 . .............................................................................................................................. 31
2.2.3.1 企業(yè)郵局購買 . .......................................................................................................... 31
2.2.3.2 企業(yè)郵局續(xù)費 . .......................................................................................................... 32
2.2.3.3 企業(yè)郵局管理 . .......................................................................................................... 32
2.2.3.3.1郵局增加郵箱個數(shù)及空間 . ................................................................................ 32
2.2.3.3.2修改郵局機房(此服務(wù)已下線) .......................................................................... 33
2.2.3.3.3修改郵局管理員密碼 . ........................................................................................ 33
2.2.3.3.4修改郵局域名 . .................................................................................................... 34
2.2.3.3.5顯示郵局信息 . .................................................................................................... 34
2.2.3.3.6 DIY-G 郵局試用業(yè)務(wù)轉(zhuǎn)為正式業(yè)務(wù) .................................................................. 35
2.2.3.3.7 查詢郵箱當(dāng)前已使用的帳號數(shù) ........................................................................ 35
2.2.3.4企業(yè)郵局升級 . ........................................................................................................... 35
2.2.4業(yè)務(wù)操作類 . ...................................................................................................................... 36
2.2.4.1 業(yè)務(wù)狀態(tài)讀取 . .......................................................................................................... 36
2.2.4.2 業(yè)務(wù)記錄批量讀取 . .................................................................................................. 37
2.2.4.3 財務(wù)流水記錄批量讀取 . .......................................................................................... 37
2.2.4.3 賬戶余額顯示 . .......................................................................................................... 38
2.2.4.4提取產(chǎn)品價格 . ........................................................................................................... 39
3. 應(yīng)答代碼...................................................................................................................................... 40
3.1. 成功返回 ................................................................................................................................ 40
3.2. 處理中返回，等待成功 ........................................................................................................ 40
3.3. 失敗返回，不可能成功 ........................................................................................................ 40
4. 應(yīng)用示例...................................................................................................................................... 41
4．1 CN 英文域名注冊 ................................................................................................................ 41
4．2國際英文域名注冊 . .............................................................................................................. 42
4．3國際中文域名注冊 . .............................................................................................................. 42
4．4國內(nèi)中文域名注冊 . .............................................................................................................. 44
4．5國際英文域名續(xù)費 . .............................................................................................................. 45
4．6國內(nèi)中文域名過戶 . .............................................................................................................. 46
5．錯誤代碼................................................................................................................................... 47
6. 附件一：域名后綴 . ..................................................................................................................... 48
6.1 CN 英文域名(國內(nèi)英文域名) . ................................................................................................ 48
6.2 國內(nèi)中文域名(CNNIC中文通用域名) ................................................................................. 49
6.3 國際英文域名 ......................................................................................................................... 50
6.4 國際中文域名 ......................................................................................................................... 50
6.5 N AME 域名 ............................................................................................................................... 50
6.6 M OBI 域名 . ............................................................................................................................... 50
6.7 B IZ 域名 ................................................................................................................................... 50
6.8 I NFO 域名 ................................................................................................................................. 50 Document No.: 001 第 3 頁 共 60頁 VER: 1.0
,中國萬網(wǎng)域名API 接口說明文檔
6.9 CC域名 . .................................................................................................................................... 50
6.10 TV域名 . .................................................................................................................................. 50
6.11 ASIA域名 . ............................................................................................................................... 50
6.12 ME域名 .................................................................................................................................. 50
6.13 TEL域名 ................................................................................................................................. 50
7. 附件二：國家列表 . ..................................................................................................................... 51
8. 附件三：單位行業(yè) . ..................................................................................................................... 56
9. 附件四: 域名WHOIS 接口 ...................................................................................................... 57
9.1域名CHECK . ............................................................................................................................. 57
9.2域名INFO ................................................................................................................................. 58
10. 附件五: 虛擬主機，企業(yè)郵局配置及功能表 ........................................................................ 59
10.1虛擬主機 . ............................................................................................................................... 59
10.2 虛擬主機升級關(guān)系 . ....................................................................................................... 59 10.3 企業(yè)郵箱 ............................................................................................................................... 59
1．API 接口地址
接口采用HTTP ，POST 協(xié)議：
正式URL ：http:// api.hichina.com/wwwnetcn.aspx
調(diào)用說明：
接口使用萬網(wǎng)分銷商級別的數(shù)字ID （以下本文檔簡稱為數(shù)字ID ），即可調(diào)用。
2．參數(shù)說明
2．1公共參數(shù)
注：所有各參數(shù)字符集為gb2312
以下參數(shù)是在訪問接口時必須提供的，否則服務(wù)器直接返回錯誤信息。
Document No.: 001 第 4 頁 共 60頁 VER: 1.0
,中國萬網(wǎng)域名API 接口說明文檔
2．2行為參數(shù)（action ）
根據(jù)不同功能，選擇不同的行為數(shù)值，每次調(diào)用只能選擇一種行為。
2.2.1域名類
2.2.1.1域名注冊 action=activate
詳細(xì)參數(shù)列表：
注：所有參數(shù)名稱中英文字母都是小寫
另注:國內(nèi)域名請按下列紅字提醒添加購買后提示! “您的域名剛提交成功，只有通過域名注冊
管理機構(gòu)CNNIC 的審核才表時您的域名正式注冊成功。請您確保域名正式注冊成功后再提交續(xù)費，否則因為CNNIC 審核不通過而刪除域名，將不退還續(xù)費的費用。我們建議您在新域名成功15日后
Document No.: 001 第 5 頁 共 60頁 VER: 1.0
中國萬網(wǎng)域名API 接口說明文檔
再提交續(xù)費。給您帶來不便之處，敬請諒解?！?/p>
(此操作是收費的)
Document No.: 001 第 6 頁 共 60頁 VER: 1.0
,中國萬網(wǎng)域名API 接口說明文檔
Document No.: 001 第 7 頁 共 60頁 VER: 1.0
中國萬網(wǎng)域名API 接口說明文檔
文字說明：
a. 其中聯(lián)系人包括以下四種，
注冊人、管理人、繳費人、技術(shù)人
注冊人的信息是必須的，其他聯(lián)系人，可以和前面相同，也可以單獨提供。例如單獨提供管理人信息，在注冊人相應(yīng)參數(shù)前面加“a_”。
如：
a_ address_zh=北京市東城區(qū)鼓樓外大街27號萬網(wǎng)大廈3層 a_name=韋小寶 ?等。
如果和注冊人相同，設(shè)置admin_same_as參數(shù)的值為2。 如：
admin_same_as=2
b 如果admin_same_as,tech_same_as,bill_same_as賦值，則無需提供各自對應(yīng)的聯(lián)系人信息的每個參數(shù)的值。
c. 注冊asia 域名, 技術(shù)人信息是必須的, 而且只能為萬網(wǎng)信息, 不能單獨提供, 使用與萬網(wǎng)相同的技術(shù)人共享模式, 設(shè)置參數(shù)tech_same_as的值為1. 如:
tech_same_as=1 ?
2.2.1.2修改聯(lián)系人 action= chgcontact
(此操作是免費的) 詳細(xì)參數(shù)列表：
Document No.: 001 第 8 頁 共 60頁 VER: 1.0
中國萬網(wǎng)域名API 接口說明文檔
注：
中文類域名上述信息為中文內(nèi)容，包括： CN 英文域名(國內(nèi)英文域名) 國內(nèi)中文域名
英文類域名上述信息為英文內(nèi)容，包括： 國際英文域名 國際中文域名 Name 域名 .mobi 域名 .biz 域名
Document No.: 001 第 9 頁 共 60頁 VER: 1.0
中國萬網(wǎng)域名API 接口說明文檔
2.2.1.3域名續(xù)費 action= renew
(此操作是收費的)
詳細(xì)參數(shù)列表：
2.2.1.4注冊主機(創(chuàng)建域名服務(wù)器) action= regdns
(此操作是收費的)
詳細(xì)參數(shù)列表：
2.2.1.5修改解析服務(wù)器(域名DNS 修改) action=chgdns
Document No.: 001 第 10 頁 共 60頁 VER: 1.0