中科图灵开放平台 / 智慧消防设备管理模块 / 获取报警日志列表信息 -- 实时故障弹窗 (可用于实时监测)

获取报警日志列表信息 -- 实时故障弹窗 (可用于实时监测)

接口描述: 获取报警日志列表信息 -- 实时故障弹窗 (可用于实时监测)

HTTP/HTTPS
请求协议
GET
请求方式
UTF-8
编码格式
JSON
返回格式
v1.0
版本号

接口参数

参数名字类型是否必须默认值其他说明
access_token字符串可选访问令牌,仅当开启签名验证时需要传递,生成令牌可使用App.Auth.ApplyToken接口
deptId整型必须-部门id 示例
pageNum整型必须-当前页 示例
pageSize整型必须-每页大小 示例
code字符串必须-设备编码 示例
confirm整型必须-报警日志确认 1: 确认 0:未确认 示例
system字符串必须-所属系统 示例
status整型必须-报警状态 0故障 1报警 示例
alarmType字符串必须-1:真实火警 2:误报 3:测试 示例
alarmBeginTime字符串必须-报警开始时间 示例
alarmEndTime字符串必须-报警结束时间 示例
isDept字符串必须-0:单位节点 1:区域节点 示例
apiRequestRaw字符串可选-
headerInfo字符串可选-[]

返回字段

返回结果类型说明
ret整型状态码,200表示成功,4xx表示客户端非法请求,5xx表示服务器错误
data对象或混合类型业务数据,由各自接口指定,通常为对象
data.code字符串
data.msg字符串
data.dataArray
data.data>>pageNum字符串
data.data>>pageSize字符串
data.data>>size字符串
data.data>>startRow字符串
data.data>>endRow字符串
data.data>>total字符串
data.data>>pages字符串
data.data>>list数组
data.data>>list>>deptName字符串部门名称
data.data>>list>>deptId字符串部门id
data.data>>list>>code字符串设备编码
data.data>>list>>system字符串所属系统
data.data>>list>>systemName字符串系统名称
data.data>>list>>addressDesc字符串位置描述
data.data>>list>>status字符串状态 -1未启用 0故障 1报警 2正常 4离线
data.data>>list>>alarmReason字符串报警原因
data.data>>list>>alarmTime字符串报警时间
data.data>>list>>confirmUserId字符串确认用户
data.data>>list>>confirmUserName字符串用户名
data.data>>list>>confirmTime字符串确认时间
data.data>>list>>alarmType字符串确认类型
data.data>>prePage字符串
data.data>>nextPage字符串
data.data>>isFirstPage字符串
data.data>>isLastPage字符串
data.data>>hasPreviousPage字符串
data.data>>hasNextPage字符串
data.data>>navigatePages字符串
data.data>>navigatepageNums数组
data.data>>navigateFirstPage字符串
data.data>>navigateLastPage字符串
data.data>>firstPage字符串
data.data>>lastPage字符串
data.data>>list>>isHandle字符串是否被处理,被确认 0未处理 1已处理
data.data>>list>>messageId字符串报警或者故障id 查用详情的id
data.data>>list>>buildId字符串建筑id
data.data>>list>>floor字符串楼层id 通过建筑id和楼层id可以获取到平面图
msg字符串提示信息,失败时的错误提示

在线测试   

参数是否必须
service 必须
access_token 可选
deptId 必须
pageNum 必须
pageSize 必须
code 必须
confirm 必须
system 必须
status 必须
alarmType 必须
alarmBeginTime 必须
alarmEndTime 必须
isDept 必须
apiRequestRaw 可选
headerInfo 可选

客户端请求示例

成功响应返回示例:
{
    "code": 0,
    "msg": null,
    "data": {
        "pageNum": 1,
        "pageSize": 10,
        "size": 10,
        "startRow": 1,
        "endRow": 10,
        "total": 20,
        "pages": 2,
        "list": [
            {
                "deptName": "一般单位1",
                "deptId": 14,
                "code": "4664567a0001",
                "system": "fc_system_xfys",
                "systemName": "消防用水",
                "addressDesc": "位置非常好",
                "status": 0,
                "alarmReason": "欠流(A相电流:0,B相电流:0,C相电流:190)",
                "alarmTime": "2020-07-15 14:34:48",
                "confirmUserId": null,
                "confirmUserName": null,
                "confirmTime": null,
                "alarmType": null,
                "deviceId": 3,
                "messageId": 112,
                "isHandle": 0,
                "buildId": 1,
                "floor": 2
            },
            {
                "deptName": "一般单位1",
                "deptId": 14,
                "code": "4664567a0001",
                "system": "fc_system_xfys",
                "systemName": "消防用水",
                "addressDesc": "位置非常好",
                "status": 0,
                "alarmReason": "欠压(C相电压:228,B相电压:0)",
                "alarmTime": "2020-07-15 14:34:48",
                "confirmUserId": null,
                "confirmUserName": null,
                "confirmTime": null,
                "alarmType": null,
                "deviceId": 3,
                "messageId": 113,
                "isHandle": 0,
                "buildId": 1,
                "floor": 2
            },
            {
                "deptName": "一般单位1",
                "deptId": 14,
                "code": "4664567a0001",
                "system": "fc_system_dqhz",
                "systemName": "电气火灾",
                "addressDesc": "位置非常好",
                "status": 1,
                "alarmReason": "欠压(C相电压:0,B相电压:0)",
                "alarmTime": "2020-07-02 16:03:52",
                "confirmUserId": 1,
                "confirmUserName": "张三s",
                "confirmTime": "2020-07-01 10:43:34",
                "alarmType": "1",
                "deviceId": 3,
                "messageId": 103,
                "isHandle": 1,
                "buildId": 1,
                "floor": 2
            },
            {
                "deptName": "一般单位1",
                "deptId": 14,
                "code": "4664567a0001",
                "system": "fc_system_dqhz",
                "systemName": "电气火灾",
                "addressDesc": "位置非常好",
                "status": 1,
                "alarmReason": "欠压(C相电压:0,B相电压:0)",
                "alarmTime": "2020-07-02 16:03:52",
                "confirmUserId": 1,
                "confirmUserName": "张三s",
                "confirmTime": "2020-07-01 10:43:34",
                "alarmType": "1",
                "deviceId": 3,
                "messageId": 104,
                "isHandle": 1,
                "buildId": 1,
                "floor": 2
            },
            {
                "deptName": "一般单位1",
                "deptId": 14,
                "code": "4664567a0001",
                "system": "fc_system_dqhz",
                "systemName": "电气火灾",
                "addressDesc": "位置非常好",
                "status": 1,
                "alarmReason": "欠压(C相电压:0,B相电压:0)",
                "alarmTime": "2020-07-02 16:03:51",
                "confirmUserId": 1,
                "confirmUserName": "张三s",
                "confirmTime": "2020-07-01 10:43:34",
                "alarmType": "2",
                "deviceId": 3,
                "messageId": 106,
                "isHandle": 1,
                "buildId": 1,
                "floor": 2
            },
            {
                "deptName": "一般单位1",
                "deptId": 14,
                "code": "4664567a0001",
                "system": "fc_system_dqhz",
                "systemName": "电气火灾",
                "addressDesc": "位置非常好",
                "status": 1,
                "alarmReason": "欠压(C相电压:0,B相电压:0)",
                "alarmTime": "2020-07-02 16:03:51",
                "confirmUserId": 1,
                "confirmUserName": "张三s",
                "confirmTime": "2020-07-01 10:43:34",
                "alarmType": "1",
                "deviceId": 3,
                "messageId": 100,
                "isHandle": 1,
                "buildId": 1,
                "floor": 2
            },
            {
                "deptName": "一般单位1",
                "deptId": 14,
                "code": "4664567a0001",
                "system": "fc_system_dqhz",
                "systemName": "电气火灾",
                "addressDesc": "位置非常好",
                "status": 1,
                "alarmReason": "欠压(C相电压:0,B相电压:0)",
                "alarmTime": "2020-07-02 16:03:51",
                "confirmUserId": 1,
                "confirmUserName": "张三s",
                "confirmTime": "2020-07-01 10:43:34",
                "alarmType": "1",
                "deviceId": 3,
                "messageId": 101,
                "isHandle": 1,
                "buildId": 1,
                "floor": 2
            },
            {
                "deptName": "一般单位1",
                "deptId": 14,
                "code": "4664567a0001",
                "system": "fc_system_dqhz",
                "systemName": "电气火灾",
                "addressDesc": "位置非常好",
                "status": 1,
                "alarmReason": "欠压(C相电压:0,B相电压:0)",
                "alarmTime": "2020-07-02 16:03:51",
                "confirmUserId": 1,
                "confirmUserName": "张三s",
                "confirmTime": "2020-07-01 10:43:34",
                "alarmType": "2",
                "deviceId": 3,
                "messageId": 105,
                "isHandle": 1,
                "buildId": 1,
                "floor": 2
            },
            {
                "deptName": "一般单位1",
                "deptId": 14,
                "code": "4664567a0001",
                "system": "fc_system_dqhz",
                "systemName": "电气火灾",
                "addressDesc": "位置非常好",
                "status": 1,
                "alarmReason": "欠压(C相电压:0,B相电压:0)",
                "alarmTime": "2020-07-02 16:03:51",
                "confirmUserId": 1,
                "confirmUserName": "张三s",
                "confirmTime": "2020-07-01 10:43:34",
                "alarmType": "1",
                "deviceId": 3,
                "messageId": 102,
                "isHandle": 1,
                "buildId": 1,
                "floor": 2
            },
            {
                "deptName": "一般单位1",
                "deptId": 14,
                "code": "4664567a0002",
                "system": "fc_system_dqhz",
                "systemName": "电气火灾",
                "addressDesc": "位置非常好",
                "status": 1,
                "alarmReason": "欠压(C相电压:227,B相电压:0)",
                "alarmTime": "2020-07-01 11:01:00",
                "confirmUserId": 1,
                "confirmUserName": "张三s",
                "confirmTime": "2020-07-01 10:43:34",
                "alarmType": "2",
                "deviceId": 4,
                "messageId": 14,
                "isHandle": 1,
                "buildId": 1,
                "floor": 2
            }
        ],
        "prePage": 0,
        "nextPage": 2,
        "isFirstPage": true,
        "isLastPage": false,
        "hasPreviousPage": false,
        "hasNextPage": true,
        "navigatePages": 8,
        "navigatepageNums": [
            1,
            2
        ],
        "navigateFirstPage": 1,
        "navigateLastPage": 2,
        "firstPage": 1,
        "lastPage": 2
    }
}
失败响应返回示例:

错误列表

错误状态码错误描述信息
400ret=400,客户端参数错误或非法请求
404表示接口服务不存在
406ret=406,access_token令牌校验不通过
407ret=407,app_key权限不足,或未知应用
408ret=408,当前用户禁止使用,或用户未登录
409ret=409,接口流量不足
500表示服务端内部错误

本文档生成时间:2024-04-27 21:53:10