一对一山姆计划|让每个人成本价享受最专业的服务器产品服务

一对一API接口:公共参数

本文档描述了一对一主机系统的域名,虚拟主机,企业邮局,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:操作出现问题