中国万网域名主机邮箱API接口.doc

第 1 页 共 61 页 1d 中国万网中国万网 域名、虚拟主机、企业邮局域名、虚拟主机、企业邮局 API 接口说明文档接口说明文档 作 者: HiChina 发行日期：2006/08/10 中国万网域名 API 接口说明文档 Document No.: 001 第 2 页 共 61 页 VER: 1.0 版本变更说明 修改日期 版本号 修改说明 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.6 DIY-G 邮局试用业务转为正式业务 2007-6.19 1.8.3 2 1 公共参数中增加业务请求序号 sourceid，用于标识 每次业务请求的序号，此值必须唯一。 2007-5.18 1.8.2 2.2.4.1 业务状态更新，增加返回”无记录”的情况 中国万网域名 API 接口说明文档 Document No.: 001 第 3 页 共 61 页 VER: 1.0 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 域名注册，英文类域名注册时，中文域名 为可选参数。 中国万网域名 API 接口说明文档 Document No.: 001 第 4 页 共 61 页 VER: 1.0 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:/ 中国万网域名 API 接口说明文档 Document No.: 001 第 5 页 共 61 页 VER: 1.0 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 接口说明文档 Document No.: 001 第 6 页 共 61 页 VER: 1.0 前言 本文档描述了中国万网域名注册，虚拟主机，企业邮局 API 接口协议。本文档描述了基 本的数据交换标准，其中包括数据格式，数据定义，以及一些相关约定。 目录 版本变更说明 2 1API 接口地址 7 2参数说明 7 21 公共参数 7 22 行为参数（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 中国万网域名 API 接口说明文档 Document No.: 001 第 7 页 共 61 页 VER: 1.0 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 41 CN 英文域名注册 33 42 国际英文域名注册 33 43 国际中文域名注册 34 44 国内中文域名注册 36 45 国际英文域名续费 37 46 国内中文域名过户 38 5错误代码 39 6.附件一：域名后缀 .40 6.1 CN 英文域名(国内英文域名 ) 40 6.2 国内中文域名(CNNIC 中文通用域名) 41 6.3 国际英文域名 42 6.4 国际中文域名 42 6.5 NAME 域名 42 6.6 MOBI 域名 .42 6.7 BIZ 域名 .42 6.8 INFO 域名 .42 6.9 CC 域名 42 6.10 TV 域名 42 7.附件二：国家列表 .42 8.附件三：单位行业 .48 9.附件四: 域名 WHOIS 接口 .48 9.1 域名 CHECK .48 中国万网域名 API 接口说明文档 Document No.: 001 第 8 页 共 61 页 VER: 1.0 9.2 域名 INFO.50 10.附件五: 虚拟主机，企业邮局配置及功能表 .51 10.1 虚拟主机 .51 10.2 特色虚拟主机 .53 10.3 企业邮箱 54 10.4 神通百变企业邮箱 VIP55 1API 接口地址 接口采用HTTP，POST协议： 正式URL ：http:/ 调用说明： 接口使用万网分销商级别的数字ID（以下本文档简称为数字 ID） ，即可调用。 测试URL ：http:/ :8081/wwwnetcn.aspx 注意：使用测试URL时请使用如下参数： 数字ID，即userid ：20645116 用户密码：1111 email：test 2参数说明 21 公共参数 注：所有各参数字符集为 gb2312 以下参数是在访问接口时必须提供的，否则服务器直接返回错误信息。 序号 名称 说明 类型(长度) 备注 1 userid 万网数字 ID 常量(8 位数字) 万网 8 位数字 ID 2 userstr md5( 数字 ID 常量(32 位字符) md5，API 认证函数 数字 ID(万网 8 位数字 ID) 中国万网域名 API 接口说明文档 Document No.: 001 第 9 页 共 61 页 VER: 1.0 用户密码 email vtime ) 用户密码(ID 密码 ) 邮箱(ID 下邮箱 ) vtime 为 12 位字符 例如当前时间是： 2006 年 8 月 30 日 8 点 15 分 vtime=200608300815 四项值依顺序连接,通过 md5 函 数处理后，userstr 值为 32 位的 字符串。 domain 产品类别为域名 host 产品类别为主机 mail 产品类别为邮箱 3 category all 常量 业务操作类，不具体产品类别 4 action 操作行为 常量 根据不同功能，提供不同的数值， 下面有详细说明。 5 vtime vtime 为 12 位字符 例如当前时间是： 2006 年 8 月 30 日 8 点 15 分 vtime=200608300815 注:服务器时间与北京时间相同 6 sourceid 业务请求序号 字符(16 位) 业务请求序号，用于标识每次业 务请求的序号，此值必须唯一。 22 行为参数（action） 根据不同功能，选择不同的行为数值，每次调用只能选择一种行为。 2.2.1 域名类 2.2.1.1 域名注册 action=activate 详细参数列表： 注：所有参数名称中英文字母都是小写 另注:国内域名请按下列红字提醒添加购买后提示!“您的域名刚提交成功，只有通过域名注册 管理机构 CNNIC 的审核才表时您的域名正式注册成功。请您确保域名正式注册成功后再提交续费， 否则因为 CNNIC 审核不通过而删除域名，将不退还续费的费用。我们建议您在新域名成功 15 日 中国万网域名 API 接口说明文档 Document No.: 001 第 10 页 共 61 页 VER: 1.0 后再提交续费。给您带来不便之处，敬请谅解。” (此操作是收费的) 参数名 说明 类型( 长度) 备注 domain 标准域名。 字符串 （360） 例： domainpwd 域名口令 字符串 （316） 数字及英文字母 vyear 注册年数 数字 dns1 第一个解析服务器 服务器地址 默认为万网： dns2 第二个解析服务器 服务器地址 默认为万网： productid cn com cnch comch name mobi biz info cc tv ccch tvch bizch asia me tel so co 常量 CN 英文域名(国内英文域名) 国际英文域名 国内中文域名 国际中文域名 name 域名 .mobi 域名 .biz 域名 .info 域名 .cc 域名 .tv 域名 中文.cc 域名 中文.tv 域名 中文.biz 域名 国际 asia 域名 注：域 名后缀请 见附件 1 So 域名 Co 域名 注册人信息开始 address_en 英文地址 字符串（1255） firstname 英文名 字符串（150） lastname 英文姓 字符串（150） organization_en 英文单位名称(域名所有人) 字符串（1255） city 英文城市 字符串（1255） 英文类域名需要，包括： 国际英文域名 国际中文域名 .name 域名 .mobi 域名 .biz 域名 .info 域名 .cc 域名 .tv 域名 非此八类域名，即中文域 中国万网域名 API 接口说明文档 Document No.: 001 第 11 页 共 61 页 VER: 1.0 state 英文省份 字符串（1255） 名不需要 address_zh 地址(中文) 字符串（1255） name 联系人姓名(中文) 字符串（116） organization_zh 单位名称(中文) (域名所有人) 字符串（1255） ccity 城市(中文) 字符串（1255） cstate 省份(中文) 字符串（1255） 中文类域名需要，包括： CN 英文域名 国内中文域名 非此两类域名，即英文类 域名时此 5 个参数为可选 参数。 manager 单位法人（注册人需要） 字符串（116） organization_type 单位所属行业（只有注册人需 要） 详细代 码见附 3 注：必须按附 3 格式传值 字符串（116） 中文类域名需要，包括： CN 英文域名 国内中文域名 postcode 邮政编码 数字(6) country 国家代码 字符串（2） 中国为 CN,更多 请见附 2 phone 国家代码-区号电话号-分机 数字以-分隔(30) fax 国家代码-区号传真号-分机 数字以-分隔(30) 86-01064036880-1000 分机可选 注：必须按此格式传值 2 位-11 位-4 位 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.其中联系人包括以下四种， 中国万网域名 API 接口说明文档 Document No.: 001 第 12 页 共 61 页 VER: 1.0 注册人、管理人、缴费人、技术人 注册人的信息是必须的，其他联系人，可以和前面相同，也可以单独提供。例如单独提 供管理人信息，在注册人相应参数前面加“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 标准域名 字符串（360） 0:注册人 1:管理联系人 2:缴费联系人 3:技术联系人 changetype 4:过户 注：每次只能修改一 种联系人 Asia 域名不能修改技 术联系人. organization 单位名称 字符串 （1255） 即为：域名所有人 address 地址 字符串 （1255） city 所在城市 字符串 （1255） state 所在省份 字符串 （1255） 中国万网域名 API 接口说明文档 Document No.: 001 第 13 页 共 61 页 VER: 1.0 postcode 邮政编码 数字 country 所在国家缩写 字符串(2) 中国为 CN,更 多请见 附 2 phone 国家代码-区号电话号-分机 数字以-分隔(30) 86-01064036880-1000 分机可选 fax 国家代码-区号传真号-分机 数字以-分隔(30) 86-01064036880-1000 分机可选 email 邮件地址 标准邮件地址 firstname 联系人名 英文字母 （150） lastname 联系人姓 英文字母 （150） organization_zh 单位名称(中文) 字符串 （1255） state_zh 省份(中文) 字符串 （1255） city_zh 城市(中文) 字符串 （1255） address_zh 地址(中文) 字符串 （1255） 英文类域名需要，包 括： 国际英文域名 国际中文域名 .name 域名 .mobi 域名 .biz 域名 .info 域名 .cc 域名 .tv 域名 非此八类域名不需要 name 联系人姓名 字符串（116） manager 单位法人（修改注册人/过 户需要） 字符串（316） organization_type 所属行业（修改注册人/过 户需要） 字符串（116） 中文类域名需要，包 括： CN 英文域名 国内中文域名 非此两类域名不需要 注： 中文类域名上述信息为中文内容，包括： CN 英文域名(国内英文域名) 国内中文域名 英文类域名上述信息为英文内容，包括： 国际英文域名 国际中文域名 Name 域名 .mobi 域名 .biz 域名 2.2.1.3 域名续费 action= renew 中国万网域名 API 接口说明文档 Document No.: 001 第 14 页 共 61 页 VER: 1.0 (此操作是收费的) 详细参数列表： 参数名 说明 类型 (长度) 备注 domain 域名 标准域名，例如： ,hichina.name, 也可以为通用网址，例：中 国万网，买麦网,hichina deaddate 续费后到期日 (请特别注意) 日期类型 例如： 当前域名到期日为 2007-10- 10，如要续费一年， 则 deaddate=2008-10-10 vyear 续费年数 数字 2.2.1.4 注册主机(创建域名服务器) action= regdns (此操作是收费的) 详细参数列表： 参数名 说明 类型(长度) 备注 0 数字（1） 国内英文（解析国内英文域名） 1 数字（1） 国外（解析国际域名） 2 数字（1） name 域名（解析 name 顶级域名） 3 数字（1） 国内中文（解析国内中文域名） regtype 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 (此操作是免费的) 详细参数列表： 中国万网域名 API 接口说明文档 Document No.: 001 第 15 页 共 61 页 VER: 1.0 参数名 说明 类型( 长度) 备注 domain 域名 标准域名 dnshost01 解析服务器 1 主机域名 例: dnshost02 解析服务器 2 主机域名 例: 2.2.1.6 修改域名密码 action=chgpwd (此操作是免费的) 详细参数列表： 参数名 说明 类型(长度) 备注 domain 域名 标准域名 domainpwd 域名密码 字符串 （316） 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 域名口令 字符串（316） 中国万网域名 API 接口说明文档 Document No.: 001 第 16 页 共 61 页 VER: 1.0 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 级， 0 隐含转发，1 为不隐含转发 显示域名解析记录返回代码说明： 200 表示命令请求正确 中国万网域名 API 接口说明文档 Document No.: 001 第 17 页 共 61 页 VER: 1.0 20060904 表示请求日期 SOA 1157726 NS 0 注：上面返回 xml 节点当中 record 为遍历的每条解析记录，各节点名称及值如下： type 值表示不同的记录类型： SOA 表示 SOA 记录 A 表示 A 记录 NS 表示 NS 记录 MX 表示 MX 记录,即邮件交换记录 CNAME 表示 CNAME 记录 URL 表示 URL 转发 id 值表示：记录 ID name 值表示：RR 值，并域名，例如： ， 等 values 表示：对应资源地址，如 IP，域名等。 ttl 表示：DNS 服务器上缓存时间 prio 表示：优先级 如返回如下信息需要另外购买解析条数： 中国万网域名 API 接口说明文档 Document No.: 001 第 18 页 共 61 页 VER: 1.0 300 需要购买解析条数 2.2.1.9.3 删除域名解析记录 action =del_rr (此操作是免费的) 参数名 说明 类型(长度) 备注 domain 域名 标准域名 rr_id 资源记录 ID 数字（1- 10） 此值通过 query 返回的 XML 得到 例： 7276826 即 rr_id=7276826 2.2.1.9.4 修改域名解析记录 action = modify_rr (此操作是免费的) 参数名 说明 类型(长度) 备注 domain 域名 标准域名 rr_id 资源记录 ID 数字（1- 10） 同上 type 记录类型 常量 同上 value 记录值 字符 同上 pri 级别值 数字（1-2） 同上 ttl 按原值传送 2.2.1.9.5 购买解析记录条数 action = activate_rr (此操作是收费的) 参数名 说明 类型(长度) 备注 domain 域名 标准域名 productid 11321 常量 11321 2.2.1.10 显示域名信息 action = getdomaininfo (此操作是免费的) 中国万网域名 API 接口说明文档 Document No.: 001 第 19 页 共 61 页 VER: 1.0 参数名 说明 类型(长度) 备注 domain 域名 字符 标准域名，例： 域名显示结果说明： 200 域名 2006-05-16 域名成功日 2011-05-16 域名到期日 q1w2e3r5 域名口令 主域名解析服务器 辅域名解析服务器 Beijing china 地址(英文) liang 名(英文) xiao 姓(英文) hichina 单位名称(英文) beijing 城市(英文) beijing 省份(英文) 中国北京 地址(中文) 梁晓 姓名(中文) 中国万网 单位名称(中文) 北京 城市(中文) 北京 省份(中文) 梁晓 单位法人（注册人显示） S1 单位所属行业代码 100011 邮政编码 CN 国家代码 86-01064242299-0000 电话 86-01064242299-0000 传真 liangxiao 邮件地址 填写 管理人共享模式 Beijing china 地址(英文) liang 名(英文) xiao 姓(英文) hichina 单位名称(英文) beijing 城市(英文) beijing 省份(英文) 中国北京 地址(中文) 梁晓 姓名(中文) 中国万网 单位名称(中文) 北京 城市(中文) 中国万网域名 API 接口说明文档 Document No.: 001 第 20 页 共 61 页 VER: 1.0 北京 省份(中文) 100011 邮政编码 CN 国家代码 86-01064242299-0000 电话 86-01064242299-0000 传真 liangxiao 邮件地址 填写 技术人共享模式 Beijing china 地址(英文) liang 名(英文) xiao 姓(英文) hichina 单位名称(英文) beijing 城市(英文) beijing 省份(英文) 中国北京 地址(中文) 梁晓 姓名(中文) 中国万网 单位名称(中文) 北京 城市(中文) 北京 省份(中文) 100011 邮政编码 CN 国家代码 86-01064242299-0000 电话 86-01064242299-0000 传真 liangxiao 邮件地址 填写 缴费人共享模式 Beijing china 地址(英文) liang 名(英文) xiao 姓(英文) hichina 单位名称(英文) beijing 城市(英文) beijing 省份(英文) 中国北京 地址(中文) 梁晓 姓名(中文) 中国万网 单位名称(中文) 北京 城市(中文) 北京 省份(中文) 100011 邮政编码 CN 国家代码 86-01064242299-0000 电话 86-01064242299-0000 传真 liangxiao 邮件地址 中国万网域名 API 接口说明文档 Document No.: 001 第 21 页 共 61 页 VER: 1.0 2.2.1.11 参数限制 2.2.1.11.1 Cn 域名以及国内中文域名 涉及行为: 域名注册,修改联系人 ; 参数限制: 由于 CNNIC 对 CN 域名信息比较严格,除以上限制的信息以外,其他信息也建议尽量 填写正确真实的注册信息! 2.2.2 虚拟主机类 2.2.2.1 虚拟主机购买 action = activate (此操作是收费的) 参数名 说明 类型(长 度) 备注 productid host_1 表示型空间(unix) host_2 表示型空间 ps_2 表示独享服务器型 ps_3 表示独享服务器型 ps_4 独享主机 IV 型 ps_2b 独享主机 II-B 型 ps_2b_njtel 独享主机 II-B 型（南京电信） ps_2b_dlcnc 独享主机 II-B 型（大连网通） ps_2b_gdtel 独享主机 II-B 型（广东电信） ps_3b 独享主机 III-B 型 ps_3b_dlcnc 独享主机 III-B 型（大连网 通） ps_3b_gdtel 独享主机 III-B 型（广东电 信） host_m3 M 享主机-M3（nt/unix，北京多线 /中国电信） host_g G 享主机-G1（win2008，北京多线 /中国电信） host_j2 J 享主机-J2（unix, 北京多线/中 常量 关于各主机的配置与 操作系统，请详见 附 件五：虚拟主机配 置详细表 中国万网域名 API 接口说明文档 Document No.: 001 第 22 页 共 61 页 VER: 1.0 国电信） ps_1_gdtel 独享主机 I 型（广东电信） ps_1 独享主机 I 型 ps_1_shtel 独享主机 I 型（上海电信） ps_2c_shtel 独享主机 II-C（上海电信） ps_2c_gdtel 独享主机 II-C（广东电信） ps_3b_shtel 独享主机 III-B（上海电信） ps_4_gdtel 独享主机 IV 型（广东电信） vzps_1 专享主机-卓越 I 型 ps_2c 独享主机 II-c vzps_1c 专享主机-卓越 I 型-C m2_s M 享主机 -M2-S（多线） m1_sc M 享主机-M1-S-C ps_1_bx 独享主机 I-BX ps_2_gdtel 独享主机 II 型（广东电信) ps_2b_shtel 独享主机 II-B 型（上海电信 ps_1_dlcnc 独享主机 I 型（大连网通） url_1 URL 转发主机 I 型 url_2 URL 转发主机 II 型 host_hk URL 转发香港 l_5 L 享主机-L5 l_1 L 享主机-L1 vzps_2 专享主机 II 型 (云主机) vzps_cb 云享主机-锋云普及型 ps_2c_dlcnc 独享主机 II-C（大连网通） vyear 购买年限 数字 （2） domain 主机域名, 标准域名，可以为中文域名。 例如： ,中国万网.com,中国万 网.中国 变量 如果是在万网注册的 域名，将自动解析， 否则请手工将域名解 析到主机 IP os unix 表示操作系统是 unix nt 表示操作系统是 windows 常量 型空间(unix)和 型空间(java)操作系 统只有 unix 型空间(.net)和 型空间(.net)操作系 统只有 windows 视频空间此参数为空 中国万网域名 API 接口说明文档 Document No.: 001 第 23 页 共 61 页 VER: 1.0 idc cnc 表示中国电信通 tel 表示中国电信 znsx 智能双线 njtel 南京电信 gdtel 广州电信 dlcnc 大连网通 all 北京多线 常量 主机机房位置,视频 空间、独享服务器此 参数为空 templateid 模板编号 变量 当 productID 为 web_1、web_2、web_ 3 才能有意义 mail 邮箱地址 变量 当 productID 为 web_1、web_2、web_ 3 才能有意义 company 公司名称 变量 当 productID 为 web_1、web_2、web_ 3 才能有意义 webname 网站名称 变量 当 productID 为 web_1、web_2、web_ 3 才能有意义 autoresolve 是否自动解析 常量 0 或者 1，0 为自动解 析 当 productID 为 web_1、web_2、web_ 3 才能有意义 主机购买成功显示结果说明： 200 20060516 主机成功日 2011-05-16 主机到期日 cn14054 主机管理员账号 k3y6j7k8 管理员密码 200M 主机标配空间大小 218.244.136.15 共享 IP 地址 cn13858_db 数据库名称 k2y6j8t9 数据库密码 另外，如果返回数据库信息的，会有另外的节点。 数据库类型 数据库用户 中国万网域名 API 接口说明文档 Document No.: 001 第 24 页 共 61 页 VER: 1.0 数据库密码 数据库名 ip 地址 主机登录名 主机域名 密码 注：根据国家法律规定，建设网站都需要登记备案，请您务必尽快催促您的主机客户办理备 案，我们将不定期进行检查，一经发现未备案网站，我们将随时关闭，由此造成的一切后果 由您自负。请您参看备案方法： 方法一：请您登录到 会员区 主机服务主机管理 登录名主机备案填 写备案信息提交即可。 方法二：请您登录信息产业部网站 自行提交备案申请（查看：信 息产业部 ICP 备案流程） 。 2.2.2.2 虚拟主机续费 action = renew (此操作是收费的) 参数名 说明 类型( 长度) 备注 hostadminid 主机名 字符 购买主机成功后返回的主机名 vyear 续费年限 数字（2） 主机续费成功显示结果说明： 200 20060516 主机续费成功日 2011-05-16 主机新到期日 2.2.2.3 虚拟主机升级 action = uprenew (此操作是收费的) 注： 1. 主机升级的顺序是： 型空间 型空间 型空间( 型空间(.net),型空间(java) 型空间 型空间 型空间 即低一级的空间，可升级比之高级的任一空间，高级空间不能降级。 2. 不适用独享服务器主机，以及视频空间。 3. 主机升级系统不能自动迁移 SqlServer 数据库，需客户自行操作。 中国万网域名 API 接口说明文档 Document No.: 001 第 25 页 共 61 页 VER: 1.0 4. 升级时请注意选择正确的操作系统。 参数名 说明 类型(长度) 备注 hostadminid 主机名，即被升级的主机名 字符 购买主机成功 后返回的主机 名 vyear 升级年限 数字（2） productid_ high host_2 表示型空间 host_3_db 表示型空间 host_4 表示型空间 host_5 表示型空间 host_6 表示型空间 常量 高级主机产品 ID os unix 表示操作系统是 unix nt 表示操作系统是 windows 常量 型空间 (unix)和型 空间(java)操 作系统只有 unix 型空间 (.net)和型 空间(.net)操 作系统只有 windows idc cnc 表示中国电信通 tel 表示中国电信 常量 主机机房位置 movetype 0 表示系统自动迁移 1 表示客户自行迁移 常量 网站文件迁移 方式 主机升级成功显示结果说明： 200 20060516 主机升级成功日 2011-05-16 主机新到期日 cn14054 主机管理员账号 k3y6j7k8 管理员密码 200M 主机标配空间大小 218.244.136.15 共享 IP 地址 cn13858_db 数据库名称 k2y6j8t9 数据库密码 中国万网域名 API 接口说明文档 Document No.: 001 第 26 页 共 61 页 VER: 1.0 2.2.2.4 虚拟主机管理 虚拟主机管理包括：主机增加空间，更换操作系统，更改主机管理密码，修改机房，修 改主要域名，显示主机信息。 2.2.2.4.1 主机增加空间 action = increase (此操作是收费的) 注：1.主机离到期日小于一个月，首先要进行主机续费，才能增加空间。 2.不适用独享服务器主机。 参数名 说明 类型( 长度) 备注 hostadminid 主机名 字符 amount 组数 数字（2） 每组大小为 10M 2.2.2.4.2 修改操作系统 action = changeos (此操作是收费的，一天只能提交一次) 注： 1.支持修改操作系统的主机有： host_2 表示型空间 host_3_db 表示型空间 host_4 表示型空间 host_5 表示型空间 2.不适用独享服务器主机，以及视频空间。 参数名 说明 类型( 长度) 备注 hostadminid 主机名 字符 os 主机新操作系统 常量 nt 或 unix 主机修改操作系统成功显示结果说明： 200 20060516 主机成功日 2011-05-16 主机到期日 cn14054 主机管理员账号 k3y6j7k8 管理员密码 200M 主机标配空间大小 218.244.136.15 共享 IP 地址 中国万网域名 API 接口说明文档 Document No.: 001 第 27 页 共 61 页 VER: 1.0 cn13858_db 数据库名称 k2y6j8t9 数据库密码 2.2.2.4.3 修改主机管理密码 (FTP 密码) action = changepwd (此操作是免费的) 注：不适用独享服务器主机。 参数名 说明 类型( 长度) 备注 hostadminid 主机名 字符 password 主机新密码 字符（3-20） 2.2.2.4.4 修改机房 action = changeidc (此操作是免费的, 一天只能提交一次) 注：不适用独享服务器主机，以及视频空间。 参数名 说明 类型(长度) 备注 hostadminid 主机名 字符 changetype 0 表示系统自动迁移 1 表示客户 FTP 迁移 常量 客户网站迁移方式 idc cnc 表示中国电信通 tel 表示中国电信 常量 主机新机房 主机修改机房成功显示结果说明： 200 20060516 主机成功日 2011-05-16 主机到期日 cn14054 主机管理员账号 k3y6j7k8 管理员密码 200M 主机标配空间大小 218.244.136.15 共享 IP 地址 cn13858_db 数据库名称 k2y6j8t9 数据库密码 2.2.2.4.5 修改主机域名 action = changedomain (此操作是免费的) 注：不适用独享服务器主机，以及视频空间。 参数名 说明 类型( 长度) 备注 中国万网域名 API 接口说明文档 Document No.: 001 第 28 页 共 61 页 VER: 1.0 hostadminid 主机名 字符 domain 新主机域名为标准域名， 可以为中文域名。例如： ,中国万网. com,中国万网.中国 常量 如果是在万网注册的域名，将 自动解析，否则请手工将新域 名解析到主机 IP, 2.2.2.4.6 显示主机信息 action = gethostinfo (此操作是免费的) 参数名 说明 类型(长度) 备注 hostadminid 主机名 字符 主机显示结果说明： 200 20060516 主机成功日 2011-05-16 主机到期日 wd003pca pcAnywhere 帐号 cn14054 主机管理员帐号 主机域名 k3y6j7k8 管理员密码 nt 操作系统类型 中国网通 放置地点 200M 主机标配空间大小 200M 主机当前空间大小 218.244.136.15 共享 IP 地址 cn13858_db 数据库名称 k2y6j8t9 数据库密码 2 主机备案状态(0 成功，1 失败，2 处理中,9 未提交) 2.2.3 邮箱类 2.2.3.1 企业邮局购买 action = activate (此操作是收费的) 中国万网域名 API 接口说明文档 Document No.: 001 第 29 页 共 61 页 VER: 1.0 参数名 说明 类型(长度) 备注 productid mail_diy_2 型 DIY 邮箱 （每个 1G） mail_group 集团邮箱 VPS-10G（500 个*20M） mail_group_2 集团邮箱 VPS-20G（500 个*40M） mail_group_s100 集团邮局 S100（100 个*50M） mail_group_s200 集团邮局 S200（200 个*50M） mail_group_s300 集团邮局 S300（300 个*50M） mail_diy_safe DIY-G 邮箱安全加强版（每个 1G） mail_cloud_max 云邮无限量 最少 5 个 mail_cloud_100m 云邮 100M 最少 3 个 mail_cloud_10g 云邮 10G 最少 3 个 mail_cloud_3g 云邮 3G 最少 5 个 mail_cloud_1g 云邮 1G 最少 50 个 常量 关于各邮箱的配 置与请详见 附件五：邮箱配 置详细表 vyear 购买年限 数字 （2） domain 邮箱域名, 标准域名 变量 如果是在万网注 册的 域名，将自动解 析，否则请手工 添加邮箱 MX 及 A 记录 集团邮箱此参数 为空 amount 帐号数量 整数 0 amount 2000 当 productid 为 mail_diy_1、mai l_diy_2 时，此参 数为必填. idc cnc 表示中国电信通 tel 表示中国电信 常量 集团邮箱此参数 为空 tryout 是否是试用 常量 当为 1 时，表示 试用，试用期为 15 天。此参数只 有在 productid 为 mail_diy_2 才 有效 中国万网域名 API 接口说明文档 Document No.: 001 第 30 页 共 61 页 VER: 1.0 邮箱购买成功显示结果说明： 200 20060516 邮箱成功日 2011-05-16 邮箱到期日 邮箱业务内容 postmaster 邮箱管理员账号 k3y6j7k8 邮箱管理员密码 200M 邮箱标配空间大小 20 邮箱标配个数 218.244.136.15 共享 IP 地址 2.2.3.2 企业邮局续费 action = renew (此操作是收费的) 参数名 说明 类型( 长度) 备注 domain 邮箱域名, 标准域名 字符 例如： 注：如为集团邮局此参数为集团 邮局业务内容, 例:mxvps302 vyear 续费年限 数字（2） 邮箱续费成功显示结果说明： 200 20060516 邮箱续费成功日 2011-05-16 邮箱新到期日 2.2.3.3 企业邮局管理 2.2.3.3.1 邮局增加邮箱个数及空间 action = addemail (此操作是收费的) 注：不适用集团邮箱。 中国万网域名 API 接口说明文档 Document No.: 001 第 31 页 共 61 页 VER: 1.0 参数名 说明 类型( 长度) 备注 domain 邮箱域名, 标准域名 字符 例如： team 增加邮箱的组数 数字（2） 每组 10 个 amount 增加邮箱的个数 数字（2） amount 和 team 只传一个即可， 并且 amount 比 team 优先 成功显示结果说明： 200 20060516 业务成功日 200M 邮箱增加后总空间大小 20 邮箱增加后总个数 2.2.3.3.2 修改邮局机房 (此服务已下线) action = changeidc (此操作是免费的, 一天只能提交一次) 注：不适用集团邮箱。 参数名 说明 类型(长度) 备注 domain 邮箱域名, 标准域名 字符 例如： idc cnc 表示中国电信通 tel 表示中国电信 常量 邮局新机房 修改机房成功显示结果说明： 200 20060516 业务成功日 postmaster 邮箱管理员账号 k3y6j7k8 邮箱管理员密码 200M 邮箱标配空间大小 20 邮箱标配个数 218.244.136.15 共享 IP 地址 2.2.3.3.3 修改邮局管理员密码 action = changepwd (此操作是免费的) 注：不适用集团邮箱。 中国万网域名 API 接口说明文档 Document No.: 001 第 32 页 共 61 页 VER: 1.0 参数名 说明 类型(长度) 备注 domain 邮箱域名, 标准域名 字符 例如： passwo