Appearance
查询状态统计
接口说明
查询账号下设备状态信息。
请求URL
本接口通用参数里面method的值为jimi.open.report.state
HTTP请求方式
GET/POST
请求参数
(1)通用参数
参见: 通用参数
(2)私有参数
| 参数名 | 参数类型 | 是否必须 | 默认值 | 描述 |
|---|---|---|---|---|
| access_token | String | 是 | 访问令牌,表明其是一个合法第三方 | |
| account | String | 是 | 无 | 查询账号(包含子级账号) |
| state | String | 否 | 无 | 设备状态,[0-离线,1-在线,2-行驶,3-静止,不填表示全部状态] |
| subordinated | String | 否 | false | 是否包含下级设备,[false-否,true-是,不填默认false] |
| paidOff | String | 否 | false | 是否包含已还清车辆,[false-否,true-是,不填默认false] |
| imeis | String | 否 | 无 | 设备IMEI号,多个用逗号隔开,最大查询1000个 |
| pageNo | Integer | 否 | 1 | 当前页,默认1 |
| pageSize | Integer | 否 | 20 | 当前页大小,默认20,最大1000 |
返回值
| 参数 | 类型 | 描述 |
|---|---|---|
| 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 | 车牌号 |
| imei | String | IMEI号 |
| orgName | String | 所属部门 |
| deviceName | String | 设备名称 |
| salesman | String | 业务员 |
| deviceType | String | 设备机型 |
| carEngineNumber | String | 车型 |
| carFrameNumber | String | 车架号 |
| status | String | 状态,(0-离线,1-在线,2-行驶,3-静止) |
| lng | String | 经度 |
| lat | String | 纬度 |
| date | String | 时间 |
| lngLat | String | 经度/纬度 |
| addr | String | 详细地址 |
| times | Integer | 时长,单位秒 |
| speed | String | 速度 |
| gpsTime | String | 定位时间 |
| hbTime | String | 心跳时间 |
| newCapitalAccount | String | 所属资方 |
| distance | Double | 总里程-- 单位:千米 |
正确返回示例:
js
{
"code": 0,
"message": "success",
"result": {
"page": 1,
"size": 20,
"number": 2,
"lastPage": true,
"items": [
{
"carId": "",
"carOwnerName": "",
"carPlateNumber": "",
"imei": "201808221000079",
"carOwnerPhone": "",
"orgName": "ES003",
"deviceName": "GT300-00079",
"salesman": "",
"deviceType": "GT300",
"carEngineNumber": "",
"carFrameNumber": "",
"status": "0",
"lat": 22.540203,
"lng": 113.91854,
"date": "2018-08-22 15:04:54",
"lngLat": "113.91854/22.540203",
"addr": "广东省深圳市南山区红花路19号,南山区文体中心西北63米",
"times": 444446,
"speed": 0,
"gpsTime": "2018-08-22 15:07:56",
"hbTime": "2018-08-22 15:04:54",
"newCapitalAccount": "下级新资方1",
"distance": 5001.71
},
{
"carId": 46049,
"carOwnerName": "BB",
"carPlateNumber": "BB-02",
"imei": "201808221000012",
"carOwnerPhone": "13812345678",
"orgName": "ES001",
"deviceName": "GT230-00012",
"salesman": "李四8",
"deviceType": "GT230",
"carEngineNumber": "123456796",
"carFrameNumber": "123456796",
"status": "0",
"lat": 22.540203,
"lng": 113.91854,
"date": "2018-08-22 15:05:34",
"lngLat": "113.91854/22.540203",
"addr": "广东省深圳市南山区红花路19号,南山区文体中心西北63米",
"times": 444407,
"speed": 0,
"gpsTime": "2018-08-22 15:07:56",
"hbTime": "2018-08-22 15:05:34",
"newCapitalAccount": "下级新资方1",
"distance": 5001.71
},
..........
]
}
}错误返回示例:
js
{"code":xxx,"message":"非法用户"}