一对一机房自动化API接口:公共参数

本文档描述了一对一机房自动化被控的API接口协议。

1.API接口地址
接口采用HTTP,POST提交方式,接口字符集为gb2312:
接口URL:http://被控IP:82/api.asp

2.返回参数说明
返回的日期使用全数字输出,PHP中可使用date与strtotime组合格式化出标准时间,ASP中可使用mid组合成标准时间

3.公共参数
以下参数是在访问接口时必须提供的,否则返回错误信息。

参数
说明
备注
client
API用户名
需先在api.asp中设置
checkTime
时间纯数字
不可重复,20161101140211年月日时分钞再加随机数
format
输出格式
支持xml与json两种格式,不定义默认json
method
操作
try,os,osinfo,oscancel,osdelete,ossn,on,off,reset,status,pxe,netadd,netdelete
checksum
校验码
md5(client &md5(apipass) & method & checkTime)

返回状态code对照:

1:正常
-1:登陆失败
-2:
-3:
-4:
-5:请求字符格式不正确
-6:不存在此接口