中国万网域名主机邮箱API接口_V2.0.3(20150115最新)

中国万网域名、虚拟主机、企业邮局A P I 接口说明文档作 者: HiChina发行日期：2014/10/13第 1 页 共 60 页 ,中国万网域名API 接口说明

中国万网

域名、虚拟主机、企业邮局

A P I 接口说明文档

作 者: HiChina

发行日期：2014/10/13

第 1 页 共 60 页

中国万网域名API 接口说明文档

前言

本文档描述了中国万网域名注册，虚拟主机，企业邮局API 接口协议。本文档描述了基本的数据交换标准，其中包括数据格式，数据定义，以及一些相关约定。

目录

1．API 接口地址 . ............................................................................................................................ 4

2．参数说明..................................................................................................................................... 4

2．1公共参数 . ................................................................................................................................ 4

2．2行为参数（ACTION ） ............................................................................................................ 5

2.2.1域名类 . ................................................................................................................................ 5

2.2.1.1域名注册 . ..................................................................................................................... 5

2.2.1.2修改联系人 . ................................................................................................................. 8

2.2.1.3域名续费 . ................................................................................................................... 10

2.2.1.4注册主机(创建域名服务器) ..................................................................................... 10

2.2.1.5修改解析服务器(域名DNS 修改) ........................................................................... 10

2.2.1.6修改域名密码 . ........................................................................................................... 11

2.2.1.7修改主机IP(修改域名服务器IP) ............................................................................ 11

2.2.1.9域名解析 . ................................................................................................................... 11

2.2.1.9.1 显示域名当前解析记录 . ................................................................................... 11

2.2.1.9.2 增加域名解析记录 . ........................................................................................... 12

2.2.1.9.3 删除域名解析记录 . ........................................................................................... 13

2.2.1.9.4 修改域名解析记录 . ........................................................................................... 14

2.2.1.9.5 购买解析记录条数 . ........................................................................................... 14

2.2.1.10 显示域名信息 . ........................................................................................................ 14

2.2.1.11 参数限制 . ................................................................................................................ 16

2.2.1.11.1 Cn域名以及国内中文域名 ............................................................................. 16

2.2.2 虚拟主机类 . ..................................................................................................................... 16

2.2.2.1 虚拟主机购买 . .......................................................................................................... 16

2.2.2.2 虚拟主机续费 . .......................................................................................................... 22

2.2.2.3 虚拟主机升级 . .......................................................................................................... 22

2.2.2.4 虚拟主机管理 . .......................................................................................................... 23

2.2.2.4.1主机增加空间 . .................................................................................................... 23

2.2.2.4.2修改操作系统 . .................................................................................................... 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

中国万网域名API 接口说明文档

2.2.2.4.6显示主机信息 . .................................................................................................... 26

2.2.2.4.7 绑定主机域名 . ................................................................................................... 26

2.2.2.5 翔云主机购买(新购已下线，只能续费) ................................................................ 27

2.2.3邮箱类 . .............................................................................................................................. 31

2.2.3.1 企业邮局购买 . .......................................................................................................... 31

2.2.3.2 企业邮局续费 . .......................................................................................................... 32

2.2.3.3 企业邮局管理 . .......................................................................................................... 32

2.2.3.3.1邮局增加邮箱个数及空间 . ................................................................................ 32

2.2.3.3.2修改邮局机房(此服务已下线) .......................................................................... 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 邮局试用业务转为正式业务 .................................................................. 35

2.2.3.3.7 查询邮箱当前已使用的帐号数 ........................................................................ 35

2.2.3.4企业邮局升级 . ........................................................................................................... 35

2.2.4业务操作类 . ...................................................................................................................... 36

2.2.4.1 业务状态读取 . .......................................................................................................... 36

2.2.4.2 业务记录批量读取 . .................................................................................................. 37

2.2.4.3 财务流水记录批量读取 . .......................................................................................... 37

2.2.4.3 账户余额显示 . .......................................................................................................... 38

2.2.4.4提取产品价格 . ........................................................................................................... 39

3. 应答代码...................................................................................................................................... 40

3.1. 成功返回 ................................................................................................................................ 40

3.2. 处理中返回，等待成功 ........................................................................................................ 40

3.3. 失败返回，不可能成功 ........................................................................................................ 40

4. 应用示例...................................................................................................................................... 41

4．1 CN 英文域名注册 ................................................................................................................ 41

4．2国际英文域名注册 . .............................................................................................................. 42

4．3国际中文域名注册 . .............................................................................................................. 42

4．4国内中文域名注册 . .............................................................................................................. 44

4．5国际英文域名续费 . .............................................................................................................. 45

4．6国内中文域名过户 . .............................................................................................................. 46

5．错误代码................................................................................................................................... 47

6. 附件一：域名后缀 . ..................................................................................................................... 48

6.1 CN 英文域名(国内英文域名) . ................................................................................................ 48

6.2 国内中文域名(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

中国万网域名API 接口说明文档

6.9 CC域名 . .................................................................................................................................... 50

6.10 TV域名 . .................................................................................................................................. 50

6.11 ASIA域名 . ............................................................................................................................... 50

6.12 ME域名 .................................................................................................................................. 50

6.13 TEL域名 ................................................................................................................................. 50

7. 附件二：国家列表 . ..................................................................................................................... 51

8. 附件三：单位行业 . ..................................................................................................................... 56

9. 附件四: 域名WHOIS 接口 ...................................................................................................... 57

9.1域名CHECK . ............................................................................................................................. 57

9.2域名INFO ................................................................................................................................. 58

10. 附件五: 虚拟主机，企业邮局配置及功能表 ........................................................................ 59

10.1虚拟主机 . ............................................................................................................................... 59

10.2 虚拟主机升级关系 . ....................................................................................................... 59 10.3 企业邮箱 ............................................................................................................................... 59

1．API 接口地址

接口采用HTTP ，POST 协议：

正式URL ：http:// api.hichina.com/wwwnetcn.aspx

调用说明：

接口使用万网分销商级别的数字ID （以下本文档简称为数字ID ），即可调用。

2．参数说明

2．1公共参数

注：所有各参数字符集为gb2312

以下参数是在访问接口时必须提供的，否则服务器直接返回错误信息。

Document No.: 001 第 4 页 共 60页 VER: 1.0

中国万网域名API 接口说明文档

2．2行为参数（action ）

根据不同功能，选择不同的行为数值，每次调用只能选择一种行为。

2.2.1域名类

2.2.1.1域名注册 action=activate

详细参数列表：

注：所有参数名称中英文字母都是小写

另注:国内域名请按下列红字提醒添加购买后提示! “您的域名刚提交成功，只有通过域名注册

管理机构CNNIC 的审核才表时您的域名正式注册成功。请您确保域名正式注册成功后再提交续费，否则因为CNNIC 审核不通过而删除域名，将不退还续费的费用。我们建议您在新域名成功15日后

Document No.: 001 第 5 页 共 60页 VER: 1.0

中国万网域名API 接口说明文档

再提交续费。给您带来不便之处，敬请谅解。”

(此操作是收费的)

Document No.: 001 第 6 页 共 60页 VER: 1.0

中国万网域名API 接口说明文档

Document No.: 001 第 7 页 共 60页 VER: 1.0

中国万网域名API 接口说明文档

文字说明：

a. 其中联系人包括以下四种，

注册人、管理人、缴费人、技术人

注册人的信息是必须的，其他联系人，可以和前面相同，也可以单独提供。例如单独提供管理人信息，在注册人相应参数前面加“a_”。

如：

a_ address_zh=北京市东城区鼓楼外大街27号万网大厦3层 a_name=韦小宝 „等。

如果和注册人相同，设置admin_same_as参数的值为2。 如：

admin_same_as=2

b 如果admin_same_as,tech_same_as,bill_same_as赋值，则无需提供各自对应的联系人信息的每个参数的值。

c. 注册asia 域名, 技术人信息是必须的, 而且只能为万网信息, 不能单独提供, 使用与万网相同的技术人共享模式, 设置参数tech_same_as的值为1. 如:

tech_same_as=1 „

2.2.1.2修改联系人 action= chgcontact

(此操作是免费的) 详细参数列表：

Document No.: 001 第 8 页 共 60页 VER: 1.0

中国万网域名API 接口说明文档

注：

中文类域名上述信息为中文内容，包括： CN 英文域名(国内英文域名) 国内中文域名

英文类域名上述信息为英文内容，包括： 国际英文域名 国际中文域名 Name 域名 .mobi 域名 .biz 域名

Document No.: 001 第 9 页 共 60页 VER: 1.0

中国万网域名API 接口说明文档

2.2.1.3域名续费 action= renew

(此操作是收费的)

详细参数列表：

2.2.1.4注册主机(创建域名服务器) action= regdns

(此操作是收费的)

详细参数列表：

2.2.1.5修改解析服务器(域名DNS 修改) action=chgdns

Document No.: 001 第 10 页 共 60页 VER: 1.0