本文档描述了一对一机房自动化被控的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:不存在此接口