《西部数码api开发协议下载版本号1.3-西部数码》.docVIP

西部数码 域名、虚拟主机、企业邮局 API接口说明文档 　　　　　　　　　　　　版本号：1.3 作 者: 西部数码 发行日期：2008/03/31 更新日期：2011-6-3 版本变更说明 修改日期 版本号 修改说明 2008-3-31 1.0 域名、虚拟主机、企业邮局购买管理等基本功能 2011-6-3 1.0 修正域名解析的部分BUG，增加域名一键登录控制面板的示例代码。 2011-8-11 增加高级接口的说明。 2012-3-27 增加获取机房说明 说明：本接口开发时间较早，有些功能没有全部实现。 /CustomerCenter/doc/west263api-new.doc 该接口为西部数码最新的api接口，功能更加强大。 前言 本文档描述了西部数码域名注册，虚拟主机，企业邮局API接口协议。本文档描述了基本的数据交换标准，其中包括数据格式，数据定义，以及一些相关约定。 目录 版本变更说明 2 1．API接口地址 7 2．参数说明 7 2．1公共参数 7 2．2行为参数（action） 8 2.2.1域名类 8 域名注册 8 修改联系人 11 域名续费 12 修改解析服务器(域名DNS修改) 13 修改域名密码 13 域名解析 14 .1 显示域名当前解析记录 14 .2 增加域名解析记录 14 .3 删除域名解析记录 16 .4 修改域名解析记录 16 0 显示域名信息 17 2.2.2 虚拟主机类 19 虚拟主机购买 19 虚拟主机续费 20 .3修改主机管理密码(FTP密码) 23 2.2.3邮箱类 25 企业邮局购买 25 企业邮局续费 26 2.2.4其它类 获取机房列表……………………………………………………………………26 3.应答代码 31 3.1. 成功返回 32 3.2. 处理中返回，等待成功 32 3.3. 失败返回，不可能成功 32 4.应用示例 32 4．1 CN英文域名注册 33 4．2国际英文域名注册 33 4．3国际中文域名注册 34 4．4国内中文域名注册 36 4．5国际英文域名续费 37 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 1．API接口地址 接口采用HTTP，GET,POST协议： 正式URL：/api/west263.asp 服务器端口：80 我司的DNS： 英文域名DNS1* IP 22 英文域名DNS2* IP 77 中文域名DNS1* IP 22 中文域名DNS2* IP 77 接口调试时可以申请试用虚拟主机、.CN类域名、.com/.net类国际域名，这类域名注册后可以删除并退款。　而.info/.tv等特殊域名请勿测试，一旦注册将不能退款。 西部数码api接口技术支持专员：028pi接口应用于华众系统的说明 ：/help/list.asp?unid=376 Api接口应用于星外系统的说明 : /faq/list.asp?unid=525 2．参数说明 2．1公共参数 注：所有各参数字符集为gb2312 以下参数是在访问接口时必须提供的，否则服务器直接返回错误信息。 序号 名称 说明 类型(长度) 备注 1 Userid 西数会员用户名 常量 西部数码会员用户名 2 Userstr md5( 会员用户名 Api连接密码 email vtime ) 常量(32位字符) md5，API认证函数数字ID(西数会员用户名)api连接用户密码邮箱(会员下邮箱) 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 Sou