阳光互联域名和主机API接口.doc

《阳光互联域名和主机API接口.doc》由会员上传分享，免费在线阅读，更多相关内容在学术论文-天天文库。

1、上海有孚域名API接口说明文档作者:sundns发行日期：2010/05/10前言本文档描述了上海有孚域名注册API接口协议。本文档描述了基本的数据交换标准，其中包括数据格式，数据定义，以及一些相关约定。目录1．API接口地址32．参数说明32．1公共参数32．2行为参数（action）42.2.1域名类42.2.1.1域名注册42.2.1.2修改联系人72.2.1.3域名续费82.2.1.4注册主机(创建域名服务器)92.2.1.5修改解析服务器(域名DNS修改)92.2.1.6修改域名密码92.2.1.7修改主机I

2、P(修改域名服务器IP)102.2.1.8域名转入102.2.1.9域名解析102.2.1.9.1显示域名当前解析记录102.2.1.9.2增加域名解析记录112.2.1.9.3删除域名解析记录122.2.1.9.4修改域名解析记录132.2.1.9.5购买解析记录条数132.2.1.10显示域名信息132.2.1.11参数限制152.2.1.11.1Cn域名以及国内中文域名152.2.2虚拟主机类152.2.2.1虚拟主机购买152.2.2.2虚拟主机续费162.2.2.4.3修改主机管理密码(FTP密码)171．A

3、PI接口地址接口采用HTTP，POST协议：正式URL：http://api.sundns.com/sundnsapi.aspx管理域名的URL:http://www.ufhost.com/domainlogin.php调用说明：接口使用阳光互联分销商级别的数字ID（以下本文档简称为数字ID），即可调用。测试URL：http://apidemo.sundns.com/sundnsapi.aspx注意：使用测试URL时请使用如下参数：数字ID，即userid：1用户密码：111111email：test@sundns.c

4、om2．参数说明2．1公共参数注：所有各参数字符集为gb2312以下参数是在访问接口时必须提供的，否则服务器直接返回错误信息。序号名称说明类型(长度)备注1Userid阳光互联数字ID常量(6位数字)阳光互联数字ID2Userstrmd5(数字ID用户密码emailvtime)常量(32位字符)md5，API认证函数数字ID(阳光互联数字ID)用户密码(ID密码)邮箱(ID下邮箱)vtime为12位字符例如当前时间是：2006年8月30日8点15分vtime=200608300815四项值依顺序连接,通过md5函数处理

5、后，userstr值为32位的字符串。3Categorydomain常量产品类别为域名host产品类别为主机mail产品类别为邮箱all业务操作类，不具体产品类别4Action操作行为常量根据不同功能，提供不同的数值，下面有详细说明。5Vtimevtime为12位字符例如当前时间是：2006年8月30日8点15分vtime=200608300815注:服务器时间与北京时间相同6Sourceid业务请求序号字符(16位)业务请求序号，用于标识每次业务请求的序号，此值必须唯一。2．2行为参数（action）根据不同功能，选

6、择不同的行为数值，每次调用只能选择一种行为。2.2.1域名类2.2.1.1域名注册action=activate详细参数列表：注：所有参数名称中英文字母都是小写另注:国内域名请按下列红字提醒添加购买后提示!“您的域名刚提交成功，只有通过域名注册管理机构CNNIC的审核才表时您的域名正式注册成功。请您确保域名正式注册成功后再提交续费，否则因为CNNIC审核不通过而删除域名，将不退还续费的费用。我们建议您在新域名成功15日后再提交续费。给您带来不便之处，敬请谅解。”(此操作是收费的)参数名说明类型(长度)备注domain标

7、准域名。字符串（3－60）例：sundns.comdomainpwd域名口令字符串（3－16）数字及英文字母vyear注册年数数字dns1第一个解析服务器服务器地址默认为阳光互联：dns2第二个解析服务器服务器地址默认为阳光互联：productidcncomcnchcomchnamemobibizinfocctvccchtvchbizchasiametel常量CN英文域名(国内英文域名)国际英文域名国内中文域名国际中文域名name域名.mobi域名.biz域名.info域名.cc域名.tv域名中文.cc域名中文.tv域

8、名中文.biz域名国际asia域名注：域名后缀请见附件1注册人信息开始address_en英文地址字符串（1－255）英文类域名需要，包括：国际英文域名国际中文域名.name域名.mobi域名.biz域名.info域名.cc域名.tv域名非此八类域名，即中文域名不需要firstname英文名字符串（1－50）lastname英文姓