## 约定
~~~
服务器默认采用UTF-8编码,数据采用JSON格式
请求:Context-Type:application/x-www-form-urlencoded
响应:Context-Type:application/json charset=utf-8
时间统一采用UTC时间,国内是北京时间,格式yyyy-MM-dd HH:mm:ss
国外环境,时间是零时区UTC时间,格式yyyy-MM-dd HH:mm:ss
~~~
## 返回数据公共属性
| 参数 | 类型 | 描述 |
| --- | --- | --- |
| code | Int | 结果码 |
| success | Boolean | 访问情况标识 |
| message | String | Code描述 |
| timestamp | Long | 时间戳 |
## Code解释
| code | 值 | 描述 |
| --- | --- | --- |
| \-1 | \-1 | 系统繁忙 |
| 0 | 0 | 成功 |
| 1xxx | 1001 | appKey错误 |
| | 1002 | 签名错误 |
| | 1003 | 用户不存在 |
| | 1004 | 用户被禁用,请联系管理员 |
| | 1005 | 无权操作,非当前账号子账号 |
| | 1006 | token为空 |
| | 1007 | token失效,请刷新或重新获取 |
| | 1008 | 超时时间超出范围,支持范围为60-7200 |
| | 1009 | refreshToken失效 |
| | 1010 | 接口调用次数已达上限 |
| 2xxx | 2001 | 设备不属于当前帐户 |
| | 2002 | 查询数量超出范围 |
| | 2003 | 起始时间不能大于结束时间 |
| | 2004 | 只能获取三个月内数据 |
| | 2005 | 有线设备,时间跨度不能超过2天 |
| | 2006 | 无线设备,时间跨度不能超过60天 |
| | 2007 | 设备不存在 |
| | 2008 | 设备已过期 |
| | 2009 | 设备未销售 |
| | 2010 | 设备已绑定 |
| 3xxx | 3001 | 指令模版不匹配 |
| | 3002 | 指令参数数量错误 |
| | 3003 | 设备不在线 |
| | 3004 | 设备接口服务时内部异常 |
| | 3005 | 等待命令回应超时 |
| | 3006 | 指令执行失败 |
| | 3007 | 该指令已存在待发送缓存 |
| | 3008 | 该指令不支持缓存 |
| 4xxx | 4001 | 车辆分组不存在 |
| | 4002 | 车辆分组已存在 |
| | 4003 | 分组中存在车辆,请转移后再尝试删除 |
| | 4004 | 该车辆已存在 |
| | 4005 | 车辆不存在 |
| | 4006 | 围栏不存在 |
| | 4007 | 围栏已存在 |
| | 4008 | 与其他围栏重叠 |
| | 4009 | 半径超出范围 |
- 目录
- 概述
- 使用场景
- 使用方法
- 协议格式
- 公共约定
- API简介
- 通信流程
- API列表
- 接口调用限制说明
- API详情
- 认证说明
- 通用参数
- 获取accessToken
- 刷新accessToken
- 注册设备到平台
- 根据账户获取设备信息
- 根据账户获取所有设备的最新定位数据
- 根据IMEI获取最新定位数据
- 根据IMEI获取设备详细信息
- 根据IMEI获取轨迹数据
- 获取设备支持的指令列表
- 指定设备发送指令
- 获取设备指令结果
- 根据用户名获取分组列表
- 创建分组
- 修改分组信息
- 删除分组
- 根据账户获取车辆列表
- 根据分组ID获取车辆列表
- 添加车辆
- 修改车牌
- 转移车辆(改变分组)
- 获取围栏列表
- 获取围栏相关车辆
- 新增围栏
- 删除围栏
- 围栏关联车辆
- 消息推送