DOC《中国万网》

中国万网 域名、虚拟主机、企业邮局 API接口说明文档 作者: HiChina 发行日期:2006/08/10 版本变更说明 修改日期 版本号 修改说明 2012-8-10 1.

9.7 1:添加域名主机邮局新产品ID,IDC的增加. 2:功能增加如保护域名注册信息新购,恢复,删除,查询,主机新功能等. 3:多种语言(.NET,JAVA,PHP,ASP,Perl)调用API demo. 4:对先前文档中参数不全的问题予以补充. 5:增加对userstr验证串md5加密方式的样例. 6:清空一些不卖的域名和邮局产品.产品标识颜色说明(绿色为不可卖且不可续费的产品,黄色是不可卖但是可续费产品,蓝色是新增的产品种类,黑色为未改变产品) 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业务状态更新,增加返回 无记录 的情况 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接口变更为: http://panda.www.net.cn/cgi-bin/check_muitl.cgi 域名check支持多后缀方式 Ajax方式变更为: http://panda.www.net.cn/cgi-bin/check_ac2.cgi 9.1域名check说明变更 2006-11-16 1.5.2 使用测试URL时请使用如下参数: 数字ID,即userid:20645116 用户密码:1111 email:[email protected] 2006-11-15 1.5.1 API接口地址由 http:// api.hichina.com:88/wwwnetcn.aspx 改为:http:// api.hichina.com/wwwnetcn.aspx 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 1.1 请求方式 GET POST均支持

8 1.1.1 Java调用格式

8 1.1.2 ASP调用格式

8 1.1.3 .NET调用格式

8 1.1.4 Php调用格式

8 1.1.5 Perl调用格式

9 2. 参数说明

10 2.1 公共参数

10 2.2 行为参数(action)

10 2.2.1 域名类

11 2.2.2 虚拟主机类

23 2.2.3 邮箱类

35 2.2.4 业务操作类

41 3. 应答代码

48 3.1 成功返回

48 3.2 处理中返回,等待成功

49 3.3 失败返回,不可能成功

49 4. 应用示例

50 4.1 CN英文域名注册

50 4.2 国际英文域名注册

51 4.3 国际中文域名注册

51 4.4 国内中文域名注册

53 4.5 国际英文域名续费

54 4.6 国内中文域名过户

55 5. 错误代码

56 6. 附件一:域名后缀

58 6.1 CN英文域名(国内英文域名)

58 6.2 国内中文域名(CNNIC中文通用域名)

59 6.3 国际英文域名

59 6.4 国际中文域名

59 6.5 Name域名

59 6.6 Mobi域名

59 6.7 Biz域名

59 6.8 Info域名

59 6.9 cc域名

59 6.10 tv域名

59 6.11 asia域名

59 6.12 me域名

59 6.13 tel域名

60 7. 附件二:国家列表

60 8. 附件三:单位行业

65 9. 附件四: 域名whois接口

66 9.1域名check

66 调用示例:

66

1、 程序实现

66

2、Internet Explorer 浏览器实现:

66 9.2域名info

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

68 10.1虚拟主机

68 10.2特色虚拟主机

70 10.3 企业邮箱

71 API接口地址 接口采用HTTP,POST协议: 正式URL:http:// api.hichina.com/wwwnetcn.aspx 调用说明: 接口使用万网分销商级别的数字ID(以下本文档简称为数字ID),即可调用. 测试URL:http:// api.hichina.com:8081/wwwnetcn.aspx 注意:使用测试URL时请使用如下参数: 数字ID,即userid:20645116 用户密码:1111 email:[email protected] 请求方式 GET POST均支持 Java调用格式 参数说明:args代表请求参数,url代表请求地址,encode代表编码方式如UTF-8,requestMethod代表请求方式如POST或GET,返回结果为String String sendRequest(Map args, String url, String encode,String requestMethod) { HttpRequest request = new HttpRequest(url, requestMethod, args);

HttpClientWrapper httpClient= new HttpClientWrapper();

HttpResponse response = httpClient.execute(request);

return response.getResponseBody(encode);

} ASP调用格式 URL代表请求地址,args代表请求参数,参数格式: 参数1=值1&

参数2=值2 responseBody为返回结果字符串 set http=server.CreateObject( WinHttp.WinHttpRequest.5.1 ) http.SetTimeouts 600000,900000,600000,600000 http.Open POST , URL, False http.SetRequestHeader Content-Type , application/x-www-form-urlencoded http.Send args If Err.Number =

0 Then vIn=http.responseBody end if .NET调用格式 byte[] postData = encoding.GetBytes(postString);

WebClient client = new WebClient();

client.Headers.Add( Content-Type , application/x-www-form-urlencoded );

client.Headers.Add( ContentLength , postData.Length.ToString());

byte[] responseData = client.UploadData(url, POST , postData);

return encoding.GetString(responseData);

Php调用格式 GET方式 $ch = curl_init(URL) ;

curl_setopt($ch, CURLOPT_RETURNTRANSFER, true) ;

curl_setopt($ch, CURLOPT_BINARYTRANSFER, true) ;

$output = curl_exec($ch) ;

$fh = fopen( out.html , '

w'

) ;

fwrite($fh, $output) ;

fclose($fh) ;

POST方式 //extract data from the post extract($_POST) ;

//set POST variables $url = url;

$fields = array( '

action'

=>

urlencode($last_name) , '

userid'

=>

urlencode($first_name) , '

title'

=>

urlencode($title) , '

company'

=>

urlencode($institution) , '

age'

=>

urlencode($age) , '

email'

=>

urlencode($email) , '

phone'

=>

urlencode($phone) );

//url-ify the data for the POST foreach($fields as $key=>

$value)........