本文档描述了一对一主机系统的域名,虚拟主机,企业邮局,VPS,数据库,服务器租用托管等产品的API接口协议。
1.API接口地址
接口采用HTTP,POST提交方式,接口字符集为gb2312:
接口URL:http://主控网址/api/api.asp
2.返回参数说明
所有返回信息中的空格都转成下划线_输出,可使用代替法还原。
返回的日期使用全数字输出,PHP中可使用date与strtotime组合格式化出标准时间,ASP中可使用mid组合成标准时间
3.公共参数
以下参数是在访问接口时必须提供的,否则返回错误信息。
参数 | 说明 | 备注 |
client | 用户名 | 主控系统中的用户名,需要先打开API功能 |
checkTime | 时间纯数字 | 不可重复,2015040109402311年月日时分钞再加随机数 |
format | 输出格式 | 支持xml与json两种格式,不定义默认json |
method | 操作 | try,create,renew,panel,getuserinfo,gethostinfo,sethostkey,getproduct,update |
checksum | 校验码 | md5(client &md5(apipass) & method & checkTime) |
返回状态code对照:
1:正常
-1:登陆失败
-2:API使用超出限制
-3:不是合法代理 (仅用于代理接口)
-4:不在代理名下 (仅用于代理接口)
-5:请求字符格式不正确
-6:不存在此接口
-8:登录失败次数过多,账号被暂时封禁
-99:此功能暂停开放,请稍候重试
-10:请求的内容格式不正确
-11:请求的数据故障
-12:产品设置问题
-13:帐号信息故障
-14:操作出现问题