中国万网域名主机邮箱API接口.docx
《中国万网域名主机邮箱API接口.docx》由会员分享，可在线阅读，更多相关《中国万网域名主机邮箱API接口.docx（88页珍藏版）》请在冰豆网上搜索。
中国万网域名主机邮箱API接口
1d
中国万网
域名、虚拟主机、企业邮局
API接口说明文档
作者:
HiChina
发行日期：
2006/08/10
版本变更说明
修改日期
版本号
修改说明
2009-5-25
1.9.6
添加域名产品“tel”域名，部分主机购买优惠一个月。
2009-05-05
1.9.5
2.2.1.2修改联系人支持中文信息，新增参数：
Organization_zh、State_zh、City_zh、Address_zh
2009-04-10
1.9.4
2.2.2.1新增主机产品3个
2008-11-5
1.9.3
2.2.2.4.6显示主机信息
添加主机备案状态
2008-09-12
1.9.2
添加域名产品“me”域名；邮箱产品DIY-G安全加强版。
2008-8-18
1.9.1
添加2.2.1.11参数限制:
cn域名以及中文国内域名注册以及修改联系人时参数限制.
2008-8-8
1.9.0
2.2.1.1域名注册处添加注释:
国内域名购买成功后,需要cnnic审核通过后方能续费.请API使用者为其页面添加注释!
2008-8-1
1.8.9
2.2.2.1新增独享主机产品9个
2008-04-28
1.8.8
2.2.1.1域名注册:
“asia”域名注册,技术联系人只能选择共享模式,不能单独提供.
2.2.1.2修改联系人:
”asia”域名不能修改技术联系人.
2008-04-22
1.8.7
域名产品添加”asia”域名
主机购买业务添加同用户同业务行为限制
2007-12-6
1.8.6
新增2.2.3.4企业邮局升级
2007-9-27
1.8.4
新增2.2.3.3.6DIY-G邮局试用业务转为正式业务
2007-6.19
1.8.3
2．1公共参数中增加业务请求序号sourceid，用于标识每次业务请求的序号，此值必须唯一。
2007-5.18
1.8.2
2.2.4.1业务状态更新，增加返回”无记录”的情况
2007-5.16
1.8.1
2.2.4业务操作类
增加productclassid参数。
2007-4.26
1.8
增加以下邮箱类产品接口：
I型DIY邮箱
参数要求见:
2.2.3.1
2007-4.24
1.7.3
增加以下域名类产品接口：
中文.biz域名
这些域名的参数要求同“国际中文域名”
2007-4.16
1.7.2
增加以下域名类产品接口：
中文.cc域名
中文.tv域名
这些域名的参数要求同“国际中文域名”
2007-2-26
1.7
增加如下内容：
2.2.4业务操作类
2.2.1.10显示域名信息
修改：
2.2.1.1域名注册，英文类域名注册时，中文域名为可选参数。
2007-1-22
1.6
1.增加泛域名解析，见2.2.1.9.2增加域名解析记录
2.增加2.2.1.9.5购买解析记录条数
3.修改“2.2.1.2修改联系人”，英文类域名必传字段firstname,lastname
4.增加以下域名类产品接口：
.biz域名
.info域名
.cc域名
.tv域名
这些域名的参数要求同“国际英文域名”
5.增加.biz域名转入，见2.2.1.8域名转入
6.注：
虚拟主机原host_5_net合并到host_5
7.增加以下主机类产品接口：
虚拟独享服务器Ⅰ型
虚拟独享服务器Ⅱ型
表示独享服务器Ⅱ型
表示独享服务器Ⅲ型
视频空间
2.2.2.3虚拟主机升级
8.增加以下邮箱类产品接口：
集团邮箱
2006-11-24
1.5.3
域名check接口变更为：
域名check支持多后缀方式
Ajax方式变更为：
9.1域名check说明变更
2006-11-16
1.5.2
使用测试URL时请使用如下参数：
数字ID，即userid：
20645116
用户密码：
1111
email：
test@
2006-11-15
1.5.1
API接口地址由
http:
//:
88/wwwnetcn.aspx
改为：
http:
//
2006-10-10
1.5
增加主机，邮箱购买接口
2006-10-8
1.3
增加mobi域名购买接口
2006-9-6
1.1.2
附件四:
域名whois接口
2006-9-5
1.1.1
增加域名解析
显示域名解析记录列表
2006-8-10
1.0
发布版本
前言
本文档描述了中国万网域名注册，虚拟主机，企业邮局API接口协议。
本文档描述了基本的数据交换标准，其中包括数据格式，数据定义，以及一些相关约定。
目录
版本变更说明2
1．API接口地址7
2．参数说明7
2．1公共参数7
2．2行为参数（action）8
2.2.1域名类8
2.2.1.1域名注册8
2.2.1.2修改联系人11
2.2.1.3域名续费12
2.2.1.4注册主机（创建域名服务器）12
2.2.1.5修改解析服务器（域名DNS修改）13
2.2.1.6修改域名密码13
2.2.1.7修改主机IP（修改域名服务器IP）13
2.2.1.8域名转入14
2.2.1.9域名解析14
2.2.1.9.1显示域名当前解析记录14
2.2.1.9.2增加域名解析记录14
2.2.1.9.3删除域名解析记录16
2.2.1.9.4修改域名解析记录16
2.2.1.9.5购买解析记录条数17
2.2.1.10显示域名信息17
2.2.2虚拟主机类19
2.2.2.1虚拟主机购买19
2.2.2.2虚拟主机续费20
2.2.2.3虚拟主机升级21
2.2.2.4虚拟主机管理22
2.2.2.4.1主机增加空间22
2.2.2.4.2修改操作系统22
2.2.2.4.3修改主机管理密码（FTP密码）23
2.2.2.4.4修改机房23
2.2.2.4.5修改主机域名24
2.2.2.4.6显示主机信息24
2.2.3邮箱类25
2.2.3.1企业邮局购买25
2.2.3.2企业邮局续费26
2.2.3.3企业邮局管理26
2.2.3.3.1邮局增加邮箱个数及空间26
2.2.3.3.2修改邮局机房（此服务已下线）27
2.2.3.3.3修改邮局管理员密码27
2.2.3.3.3修改邮局域名28
2.2.3.3.4显示邮局信息28
2.2.4业务操作类28
2.2.4.1业务状态读取28
2.2.4.2业务记录批量读取29
2.2.4.3财务流水记录批量读取30
2.2.4.3账户余额显示31
3.应答代码31
3.1.成功返回32
3.2.处理中返回，等待成功32
3.3.失败返回，不可能成功32
4.应用示例32
4．1CN英文域名注册33
4．2国际英文域名注册33
4．3国际中文域名注册34
4．4国内中文域名注册36
4．5国际英文域名续费37
4．6国内中文域名过户38
5．错误代码39
6.附件一：
域名后缀40
6.1CN英文域名（国内英文域名）40
6.2国内中文域名（CNNIC中文通用域名）41
6.3国际英文域名42
6.4国际中文域名42
6.5Name域名42
6.6Mobi域名42
6.7Biz域名42
6.8Info域名42
6.9cc域名42
6.10tv域名42
7.附件二：
国家列表42
8.附件三：
单位行业48
9.附件四:
域名whois接口48
9.1域名check48
9.2域名info50
10.附件五:
虚拟主机，企业邮局配置及功能表51
10.1虚拟主机51
10.2特色虚拟主机53
10.3企业邮箱54
10.4神通百变企业邮箱VIP55
1．API接口地址
接口采用HTTP，POST协议：
正式URL：
http:
//
调用说明：
接口使用万网分销商级别的数字ID（以下本文档简称为数字ID），即可调用。
测试URL：
http:
//:
8081/wwwnetcn.aspx
注意：
使用测试URL时请使用如下参数：
数字ID，即userid：
20645116
用户密码：
1111
email：
test@
2．参数说明
2．1公共参数
注：
所有各参数字符集为gb2312
以下参数是在访问接口时必须提供的，否则服务器直接返回错误信息。
序号
名称
说明
类型（长度）
备注
1
userid
万网数字ID
常量（8位数字）
万网8位数字ID
2
userstr
md5（
数字ID
用户密码
email
vtime
）
常量（32位字符）
md5，API认证函数
数字ID（万网8位数字ID）
用户密码（ID密码）
邮箱（ID下邮箱）
vtime为12位字符
例如当前时间是：
2006年8月30日8点15分
vtime=200608300815
四项值依顺序连接,通过md5函数处理后，userstr值为32位的字符串。
3
category
domain
常量
产品类别为域名
host
产品类别为主机
mail
产品类别为邮箱
all
业务操作类，不具体产品类别
4
action
操作行为
常量
根据不同功能，提供不同的数值，下面有详细说明。
5
vtime
vtime为12位字符
例如当前时间是：
2006年8月30日8点15分
vtime=200608300815
注:
服务器时间与北京时间相同
6
sourceid
业务请求序号
字符（16位）
业务请求序号，用于标识每次业务请求的序号，此值必须唯一。
2．2行为参数（action）
根据不同功能，选择不同的行为数值，每次调用只能选择一种行为。
2.2.1域名类
2.2.1.1域名注册
action=activate
详细参数列表：
注：
所有参数名称中英文字母都是小写
另注:
国内域名请按下列红字提醒添加购买后提示!
“您的域名刚提交成功，只有通过域名注册管理机构CNNIC的审核才表时您的域名正式注册成功。
请您确保域名正式注册成功后再提交续费，否则因为CNNIC审核不通过而删除域名，将不退还续费的费用。
我们建议您在新域名成功15日后再提交续费。
给您带来不便之处，敬请谅解。
”
（此操作是收费的）
参数名
说明
类型（长度）
备注
domain
标准域名。
字符串（3－60）
例：
domainpwd
域名口令
字符串（3－16）
数字及英文字母
vyear
注册年数
数字
dns1
第一个解析服务器
服务器地址
默认为万网：
dns2
第二个解析服务器
服务器地址
默认为万网：
productid
cn
com
cnch
comch
name
mobi
biz
info
cc
tv
ccch
tvch
bizch
asia
me
tel
常量
CN英文域名（国内英文域名）
国际英文域名
国内中文域名
国际中文域名
name域名
.mobi域名
.biz域名
.info域名
.cc域名
.tv域名
中文.cc域名
中文.tv域名
中文.biz域名
国际asia域名
注：
域名后缀请见附件1
注册人信息开始
address_en
英文地址
字符串（1－255）
英文类域名需要，包括：
国际英文域名
国际中文域名
.name域名
.mobi域名
.biz域名
.info域名
.cc域名
.tv域名
非此八类域名，即中文域名不需要
firstname
英文名
字符串（1－50）
lastname
英文姓
字符串（1－50）
organization_en
英文单位名称（域名所有人）
字符串（1－255）
city
英文城市
字符串（1－255）
state
英文省份
字符串（1－255）
address_zh
地址（中文）
字符串（1－255）
中文类域名需要，包括：
CN英文域名
国内中文域名
非此两类域名，即英文类域名时此5个参数为可选参数。
name
联系人姓名（中文）
字符串（1－16）
organization_zh
单位名称（中文）（域名所有人）
字符串（1－255）
ccity
城市（中文）
字符串（1－255）
cstate
省份（中文）
字符串（1－255）
manager
单位法人（注册人需要）
字符串（1－16）
中文类域名需要，包括：
CN英文域名
国内中文域名
organization_type
单位所属行业（只有注册人需要）
详细代码见附3
注：
必须按附3格式传值
字符串（1－16）
postcode
邮政编码
数字（6）
country
国家代码
字符串
（2）
中国为CN,更多请见附2
phone
国家代码-区号电话号-分机
数字以-分隔（30）
-010********
分机可选
注：
必须按此格式传值
4位-12位-6位
fax
国家代码-区号传真号-分机
数字以-分隔（30）
email
邮件地址
字符串
标准邮件地址
注册人信息结束
以下三种联系人，重复注册人各参数名称即可
管理人:
注册人各参数前加"a_"
缴费人:
注册人各参数前加"b_"
技术人:
注册人各参数前加"t_"
也可以使用下面的共享模式。
注:
asia域名注册时,技术人信息必须且只能为万网相同信息,信息录入选择技术人共享模式输入,tech_same_as=1
admin_same_as
管理人共享模式
1或者2
1:
与万网相同
2:
与注册人相同
tech_same_as
技术人共享模式
1或者2或者3
1:
与万网相同
2:
与注册人相同
3:
与管理人相同
bill_same_as
缴费人共享模式
1或者2或者3或者4
1:
与万网相同
2:
与注册人相同
3:
与管理人相同
4:
与技术人相同
文字说明：
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
（此操作是免费的）
详细参数列表：
参数名
说明
类型（长度）
备注
domain
标准域名
字符串（3－60）
changetype
0:
注册人
注：
每次只能修改一种联系人
Asia域名不能修改技术联系人.
1:
管理联系人
2:
缴费联系人
3:
技术联系人
4:
过户
organization
单位名称
字符串（1－255）
即为：
域名所有人
address
地址
字符串（1－255）
city
所在城市
字符串（1－255）
state
所在省份
字符串（1－255）
postcode
邮政编码
数字
country
所在国家缩写
字符串
（2）
中国为CN,更多请见附2
phone
国家代码-区号电话号-分机
数字以-分隔（30）
-010********
分机可选
fax
国家代码-区号传真号-分机
数字以-分隔（30）
-010********
分机可选
email
邮件地址
标准邮件地址
firstname
联系人名
英文字母（1－50）
英文类域名需要，包括：
国际英文域名
国际中文域名
.name域名
.mobi域名
.biz域名
.info域名
.cc域名
.tv域名
非此八类域名不需要
lastname
联系人姓
英文字母（1－50）
organization_zh
单位名称（中文）
字符串（1－255）
state_zh
省份（中文）
字符串（1－255）
city_zh
城市（中文）
字符串（1－255）
address_zh
地址（中文）
字符串（1－255）
name
联系人姓名
字符串（1－16）
中文类域名需要，包括：
CN英文域名
国内中文域名
非此两类域名不需要
manager
单位法人（修改注册人/过户需要）
字符串（3－16）
organization_type
所属行业（修改注册人/过户需要）
字符串（1－16）
注：
中文类域名上述信息为中文内容，包括：
CN英文域名（国内英文域名）
国内中文域名
英文类域名上述信息为英文内容，包括：
国际英文域名
国际中文域名
Name域名
.mobi域名
.biz域名
2.2.1.3域名续费
action=renew
（此操作是收费的）
详细参数列表：
参数名
说明
类型（长度）
备注
domain
域名
标准域名，例如：
hichina.name,也可以为通用网址，例：
中国万网，买麦网,hichina
deaddate
续费后到期日
（请特别注意）
日期类型
例如：
当前域名到期日为2007-10-10，如要续费一年，
则deaddate=2008-10-10
vyear
续费年数
数字
2.2.1.4注册主机（创建域名服务器）
action=regdns
（此操作是收费的）
详细参数列表：
参数名
说明
类型（长度）
备注
regtype
0
数字
（1）
国内英文（解析国内英文域名）
1
数字
（1）
国外（解析国际域名）
2
数字
（1）
name域名（解析name顶级域名）
3
数字
（1）
国内中文（解析国内中文域名）
4
数字
（1）
.org/.biz/.cc/.tv/.info/域名
（解析.org/.biz/.cc/.tv/.info/域名）
dnshost01
主机名
主机域名
域名服务器名称例:
dnshost01_ip
主机对应IP
标准IP
标准IP
注：
一个IP只能注册一个主机
2.2.1.5修改解析服务器（域名DNS修改）
action=chgdns
（此操作是免费的）
详细参数列表：
参数名
说明
类型（长度）
备注
domain
域名
标准域名
dnshost01
解析服务器1
主机域名
例:
dnshost02
解析服务器2
主机域名
例:
2.2.1.6修改域名密码
action=chgpwd
（此操作是免费的）
详细参数列表：
参数名
说明
类型（长度）
备注
domain
域名
标准域名
domainpwd
域名密码
字符串（3－16）
2.2.1.7修改主机IP（修改域名服务器IP）
action=chgdnshost
（此操作是免费的,一天只能提交一次）
详细参数列表：
参数名
说明
类型（长度）
备注
dnshost01
主机名
主机域名
域名服务器名称例：
dnshost01_ip
主机对应IP
标准IP
例：
218.30.102.231
2.2.1.8域名转入
action=transfer
（此操作是收费的）
详细参数列表：
参数名
说明
类型（长度）
备注
productid
cn
com
cnch
comch
biz
常量
CN英文域名（国内英文域名）
国际英文域名
国内中文域名
国际中文域名
.biz域名
domain
域名
标准域名
domainpwd
域名口令
字符串（3－16）
2.2.1.9域名解析
域名解析包括：
显示域名的当前解析记录，新增解析记录，修改，删除。
只读的记录类型有：
SOA记录，id=0的NS记录，此两类记录不能进行删改操作
可供增删改操作的记录类型有：
A记录、NS记录、MX记录、CNAME记录、URL转发记录
2.2.1.9.1显示域名当前解析记录
action=query_rr
（此操作是免费的）
参数名
说明
类型（长度）
备注
domain
域名
标准域名
2.2.1.9.2增加域名解析记录
action=add_rr
（此操作10条内是免费的）
（一个域名超过10条解析记录时，需要另外购买，购买请参见：
2.2.1.9.5购买解析记录条数）
参数名
说明
类型（宽度）
备注
domain
域名
标准域名
rr
资源记录值
字符（20）
例如：
ftp,www,mx等,可以为空,泛域名解析该此为*
type
记录类型,可为：
a
ns
mx
cname
url
常量
记录类型，分别为：
A记录
NS记录
MX记录
CNAME记录
URL转发记录
value
记录值
字符
例：
218.30.103.28
pri
例如：
5
数字
（2）
只有type=mx或type=url时此参数才有值
type=mx时意为优先级,为数字，值越小优先级越高。
type=url时意为转发形式，为0至1级，
升级会员 