Skip to content

查询状态统计

接口说明

查询账号下设备状态信息。

请求URL

本接口通用参数里面method的值为jimi.open.report.state

HTTP请求方式

GET/POST

请求参数

(1)通用参数
参见: 通用参数
(2)私有参数

参数名参数类型是否必须默认值描述
access_tokenString访问令牌,表明其是一个合法第三方
accountString查询账号(包含子级账号)
stateString设备状态,[0-离线,1-在线,2-行驶,3-静止,不填表示全部状态]
subordinatedStringfalse是否包含下级设备,[false-否,true-是,不填默认false]
paidOffStringfalse是否包含已还清车辆,[false-否,true-是,不填默认false]
imeisString设备IMEI号,多个用逗号隔开,最大查询1000个
pageNoInteger1当前页,默认1
pageSizeInteger20当前页大小,默认20,最大1000

返回值

参数类型描述
codeInt返回码:
0: 正确返回
其它: 失败。参考错误码说明
messageString如果code不为0,会有相应的错误信息提示
dataString返回的数据

result参数列表:

参数类型描述
pageInteger当前页
sizeInteger当前页查询大小
numberInteger返回数据总数
lastPageBoolean是否为最后一页
itemsArray返回数据列表

items参数列表:

参数类型描述
carIdString车辆ID
carOwnerNameString车辆名称
carPlateNumberString车牌号
imeiStringIMEI号
orgNameString所属部门
deviceNameString设备名称
salesmanString业务员
deviceTypeString设备机型
carEngineNumberString车型
carFrameNumberString车架号
statusString状态,(0-离线,1-在线,2-行驶,3-静止)
lngString经度
latString纬度
dateString时间
lngLatString经度/纬度
addrString详细地址
timesInteger时长,单位秒
speedString速度
gpsTimeString定位时间
hbTimeString心跳时间
newCapitalAccountString所属资方
distanceDouble总里程-- 单位:千米

正确返回示例:

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":"非法用户"}