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