Appearance
查询电量过低统计
接口说明
查询账号下设备电量信息。
请求URL
本接口通用参数里面method的值为jimi.open.report.lowbattery
HTTP请求方式
GET/POST
请求参数
(1)通用参数
参见: 通用参数
(2)私有参数
| 参数名 | 参数类型 | 是否必须 | 默认值 | 描述 |
|---|---|---|---|---|
| access_token | String | 是 | 访问令牌,表明其是一个合法第三方 | |
| account | String | 是 | 无 | 查询账号(包含子级账号) |
| power | Integer | 是 | 无 | 查询电量低于百分比值,只能输入[10,20,30,40,50,60,70,80,90,100] |
| subordinated | String | 否 | false | 是否包含下级设备,[false-否,true-是,不填默认false] |
| paidOff | String | 否 | false | 是否包含已还清车辆,[false-否,true-是,不填默认false] |
| deviceType | String | 否 | 无 | 设备机型 |
| pageNo | Integer | 否 | 1 | 当前页,默认1 |
| pageSize | Integer | 否 | 20 | 当前页大小,默认20,最大10000 |
返回值
| 参数 | 类型 | 描述 |
|---|---|---|
| code | Int | 返回码: 0: 正确返回 其它: 失败。参考错误码说明 |
| message | String | 如果code不为0,会有相应的错误信息提示 |
| data | String | 返回的数据 |
result参数列表:
| 参数 | 类型 | 描述 |
|---|---|---|
| page | Integer | 当前页 |
| size | Integer | 当前页查询大小 |
| number | Integer | 返回数据总数 |
| lastPage | Boolean | 是否为最后一页 |
| items | Array | 返回数据列表 |
items参数列表:
| 参数 | 类型 | 描述 |
|---|---|---|
| carId | String | 车辆ID |
| carOwnerName | String | 车辆名称 |
| carPlateNumber | String | 车牌号 |
| carOwnerPhone | String | 车主手机号 |
| imei | String | IMEI号 |
| orgName | String | 所属部门 |
| deviceName | String | 设备名称 |
| salesman | String | 业务员 |
| deviceType | String | 设备机型 |
| carEngineNumber | String | 车型 |
| carFrameNumber | String | 车架号 |
| power | Integer | 电量百分比值 |
正确返回示例:
js
{
"code": 0,
"message": "success",
"result": {
"page": 2,
"size": 20,
"number": 14, //当前页查询数量
"lastPage": true, //是否为最后一页
"items": [
{
"carId": 46053,
"carOwnerName": "CC",
"carPlateNumber": "CC-03",
"imei": "201808221000066",
"carOwnerPhone": "13812345678",
"orgName": "ES002",
"deviceName": "GT300-00066",
"salesman": "李四16",
"deviceType": "GT300",
"carEngineNumber": "123456804",
"carFrameNumber": "123456804",
"power": 5
},
{
"carId": "",
"carOwnerName": "",
"carPlateNumber": "",
"imei": "201808221000067",
"carOwnerPhone": "",
"orgName": "ES002",
"deviceName": "GT300-00067",
"salesman": "",
"deviceType": "GT300",
"carEngineNumber": "",
"carFrameNumber": "",
"power": 5
},
..........
]
}
}错误返回示例:
js
{"code":xxx,"message":"非法用户"}