Appearance
根据设备IMEI查询告警详情
接口说明
根据设备IMEI查询设备告警详情数据
请求URL
本接口通用参数里面method的值为jimi.open.device.getAlarmInfoByImei
HTTP请求方式
POST
请求参数
(1)通用参数
参见: 通用参数
(2)私有参数
| 参数名 | 参数类型 | 是否必须 | 默认值 | 描述 |
|---|---|---|---|---|
| access_token | String | 是 | 访问令牌，表明其是一个合法第三方 | |
| imeis | String | 是 | 设备imei号 (多个imei用英文逗号隔开) (最多输入100个) | |
| mcType | String | 否 | 设备机型 | |
| startTime | String | 是 | 开始时间 格式为：yyyy-MM-dd HH:MM:SS (告警时间) | |
| endTime | String | 是 | 结束时间 格式为：yyyy-MM-dd HH:MM:SS (告警时间) | |
| status | String | 否 | (参考途强开放API的附录) 设备告警类型 (支持多个查询，逗号隔开，没有告警类型的限制) | |
| page | String | 否 | 页码（从1开始） | |
| pageSize | String | 否 | 每页显示的条数（最多100条 ，默认10条） |
返回值
| 参数 | 类型 | 描述 |
|---|---|---|
| code | Int | 返回码： 0: 正确返回 其它: 失败。参考错误码说明 |
| message | String | 如果code不为0，会有相应的错误信息提示 |
| result | String | 返回的数据，成功后返回告警详情 |
result参数列表:
| 参数 | 类型 | 描述 |
|---|---|---|
| addr | String | 告警地址 |
| alarmType | String | 告警类型 |
| devName | String | 设备名称 |
| imei | String | 设备号 |
| alarmName | String | 告警名称 |
| lat | Double | 纬度 |
| lng | Double | 经度 |
| pushTime | Date | 告警时间 |
正确返回示例：
js
{
"code": 0,
"message": "success",
"result": [
{
"imei": "868120209363966",
"devName": "GT320S-63966",
"alarmType": "other",
"alarmName": "停留告警",
"addr": "广东省深圳市南山区石鼓路,深圳万科云城-3期东北118米",
"lat": 22.576631,
"lng": 113.942773,
"pushTime": "2022-11-13 20:10:01"
},
{
"imei": "868120209363966",
"devName": "GT320S-63966",
"alarmType": "other",
"alarmName": "离线告警",
"addr": "广东省深圳市南山区石鼓路,深圳万科云城-3期东北118米",
"lat": 22.576631,
"lng": 113.942773,
"pushTime": "2022-11-13 20:11:13"
},
{
"imei": "868120209363966",
"devName": "GT320S-63966",
"alarmType": "other",
"alarmName": "声控报警",
"addr": "广东省深圳市南山区石鼓路,电子检测大厦西南78米",
"lat": 22.577285669830246,
"lng": 113.94354348927926,
"pushTime": "2022-11-10 11:49:11"
},
{
"imei": "868120209363966",
"devName": "GT320S-63966",
"alarmType": "other",
"alarmName": "声控报警",
"addr": "广东省深圳市南山区石鼓路,电子检测大厦西南78米",
"lat": 22.577285669830246,
"lng": 113.94354348927926,
"pushTime": "2022-11-10 11:45:24"
},
{
"imei": "868120209363966",
"devName": "GT320S-63966",
"alarmType": "other",
"alarmName": "声控报警",
"addr": "广东省深圳市南山区石鼓路,电子检测大厦西南78米",
"lat": 22.577285669830246,
"lng": 113.94354348927926,
"pushTime": "2022-11-10 11:41:37"
},
{
"imei": "868120209363966",
"devName": "GT320S-63966",
"alarmType": "other",
"alarmName": "内部电池低电报警",
"addr": "广东省深圳市南山区石鼓路,电子检测大厦西南168米",
"lat": 22.576637802683777,
"lng": 113.9430112894536,
"pushTime": "2022-11-10 00:00:18"
}
]
}错误返回示例：
js
{
"code": 12024,
"message": "设备不存在",
"result": [
"202210211629002",
"202210211629003",
"202210211629006"
]
}
{
"code": 12026,
"message": "时间条件错误，结束时间要大于开始时间",
"result": null
}
{
"code": 12027,
"message": "开始时间不能大于当前六个月",
"result": null
}
{
"code": 12028,
"message": "单次查询时间不能大于31天",
"result": null
}