api接口文档（20100419）.doc

API文档(版本号)文件状态：[] 草 稿[ ] 正式发布[ ] 正在修改当前版本：作 者：文件密级：[ ]普通 [ ]秘密 []绝密文档版本版本/状态作者参与者日期说明API文档说明：协议:接口采用http协议,代理商只要规定的接口地址POST规定的接口参数即可.使用接口的用户对象：在主系统里拥有特殊代理帐号的会员使用前准备：在代理管理中心->站点管理->API接口设置 功能中添加您服务器的IP地址及设置好API密码POST字符串格式如下： e10adc3949ba59abbe56e057f20f883e&domainname=其中act表示命令，add，check,info,update等Username是代理商帐号Chksum是md5校验码.算法是：chksum = md5(username & domainname & otime & md5(apipass))Apipass是代理商API密码收到的返回报文如下：code:-1ErrMsg:密码认证错其中code是返回结果，0表示成功，-1表示失败ErrMsg:是错误详细表述详细命令说明：1,产品添加（包括域名注册，虚拟主机开通等所有本系统支持的产品）参数名称参数说明长度要求可选/必须act命令值为add必须Username代理商登录帐号必须otime订单时间,格式: YYYY-MM-DD HH:MM:SS,例如: 2000-02-20 12:03:33必须chksum验证码MD5必须domainname符合标准域名。

String (1-100)必须 productcode产品代码，详见产品代码表String (1-10)必须applytime申请时间Int(0-1)必须Dns1主域名解析服务器String (1-100)可选,域名类产品必须Dns2辅域名解析服务器String (1-100)可选域名类产品必须chregister注册人中文String (3-60)必须enregister注册人英文String (3-60)必须manager联系人String (3-10)必须chorganize管理机构中文String (3-60)必须enorganize管理机构英文String (3-60)必须chcountry国家中文String (2-20)必须encountry国家英文String (2-20)必须chprovince省份中文String(2-20)必须enprovince省份英文String (2-20)必须chcity城市中文String(2-20)必须encity城市英文String(2-20)必须chaddress联系地址中文String (1-60)必须enaddress联系地址英文String (1-60)必须postcode邮政编码String (6)必须telephoneno号码,如：059187202125String (1-20)必须email电子邮件String (5-30)必须faxno,如：059187202125String (1-20)必须manager管理人(中文名)String (1-20)必须返回结果:code:执行结果，0成功，-1失败ErrMsg:错误详细描述Managepass:管理密码Edate:到期时间2,查询域名是否可以注册参数名称参数说明长度要求可选/必须act命令值为check必须Username代理商登录帐号必须otime订单时间,格式: YYYY-MM-DD HH:MM:SS,例如: 2000-02-20 12:03:33必须chksum验证码MD5必须domainname符合标准域名。

String (1-100)必须 返回结果:code:执行结果，0成功，-1失败ErrMsg:错误详细描述status:是否可以注册，Y可以注册，N不可注册3,查询产品信息参数名称参数说明长度要求可选/必须act命令值为info必须Username代理商登录帐号必须otime订单时间,格式: YYYY-MM-DD HH:MM:SS,例如: 2000-02-20 12:03:33必须chksum验证码MD5必须domainname符合标准域名String (1-100)必须 productcode产品代码String (1-20)必须返回结果:code:执行结果，0成功，-1失败ErrMsg:错误详细描述status:Y正常，N暂停managepass:管理密码edate:到期时间3,重置管理密码参数名称参数说明长度要求可选/必须act命令值为reset必须Username代理商登录帐号必须otime订单时间,格式: YYYY-MM-DD HH:MM:SS,例如: 2000-02-20 12:03:33必须chksum验证码MD5必须domainname符合标准域名String (1-100)必须 productcode产品代码String (1-20)必须managepass新的管理密码String (1-20)必须返回结果:code:执行结果，0成功，-1失败ErrMsg:错误详细描述status:Y正常，N暂停managepass:管理密码edate:到期时间4,续费参数名称参数说明长度要求可选/必须act命令值为renew必须Username代理商登录帐号必须otime订单时间,格式: YYYY-MM-DD HH:MM:SS,例如: 2000-02-20 12:03:33必须chksum验证码MD5必须domainname符合标准域名。

String (1-100)必须 productcode产品代码String (1-20)必须applytime续费时间int必须返回结果:code:执行结果，0成功，-1失败ErrMsg:错误详细描述status:Y正常，N暂停managepass:管理密码 edate:到期时间如果客户需要在注册的时候选择不同的注册商，参数值为：regtype参数值编号:产品码代码表：。