getAlarmMessage（查询用户报警信息）

getAlarmMessage：查询用户报警信息

要点：https://openapi.lechange.cn/openapi/getAlarmMessage · 见错误码

获取设备通道在指定时间段内的设备消息列表。支持删除网关设备下关联的子设备消息。

请求参数

参数名	参数类型	是否必填	默认值	合法值	参数说明
token	String	是			管理员或者子账号accessToken
productId	String	否		可通过listDeviceDetailsByIds、listDeviceDetailsByPage获取	设备产品id，查询子设备消息时必填
deviceId	String	是			设备序列号
subDeviceId	String	否		可通过listDeviceDetailsByIds、listDeviceDetailsByPage获取	子设备序列号，查询子设备消息时必填
channelId	String	是			通道号
beginTime	String	是			开始时间，yyyy-MM-dd HH:mm:ss
endTime	String	是			结束时间，yyyy-MM-dd HH:mm:ss
count	Integer	否	30	1–100	每批条数，默认 30，上限 100
nextAlarmId	String	否	"-1"	"","-1",上次查询返回的nextAlarmId	下一报警Id

请求示例

{
    "system":{
        "ver":"1.0",
        "appId":"lcdxxxxxxxxx",
        "sign": "xjhCQBoJ9hRDsCjyDcHjtDNzRZ3ZJezcawsfWeiaoxU=",
        "time":1603350704,
        "nonce":"245db3c7-1689-4893-ac30-cbd7a9d8d153"
    },
    "id":"9f05aa70-91fd-4d35-8b06-cd2ece55346b",
    "params":{
        "token": "<yourAccessToken>",
        "deviceId":"TESTQWERXXXX",
        "channelId":"0",
        "nextAlarmId":"-1",
        "beginTime":"2020-10-22 00:00:00",
        "endTime":"2020-10-22 23:59:59",
        "count":10
    }
}

响应字段

字段名			字段类型	字段说明
count			Integer	当前抽取报警总数
nextAlarmId			Long	当前消息列表最后一条消息的消息Id
alarms	token		String	消息唯一标识，用于查询云录像
	name		String	通道名称
	alarmId		String	消息Id
	localDate		String	报警时设备本地时间
	type		Integer	报警类型，0：人体红外；1：动态检测；2：未知告警；3：低电压告警；4：配件人体红外检测；5：移动感应器发生移动事件；6：移动感应器长时间未发生移动事件；7：配件人体红外检测长久未报警事件；8：门磁报警事件；90：报警网关门磁探测报警；91：报警网关红外探测报警；92：报警网关低电量报警；93：报警网关防拆报警
	productId		String	IoT设备产品id，非IoT设备不返回
	deviceId		String	设备ID
	channelId		String	通道号
	refId		String	IoT设备消息类型id，非IoT设备不返回
	picurlArray		String[]	报警图片url
	thumbUrl		String	缩略图Url
	aiCopyWriting		String	AI大模型分析文案（10-20字），当设备通道使用智见云存储或AI智见套餐时才有值
	securityRiskLevel		Integer	报警事件安全风险等级，范围1~10。当设备通道使用智见云存储或AI智见套餐时才有值
	aiTag		String[]	AI分析的报警事件标签集合，包括人、车、宠物、包裹。当设备通道使用智见云存储或AI智见套餐时才有值
	feedback	type	String	检测类型，1-人形检测；2-人脸识别；3-大模型检测
	feedback	result	String[]	AI分析的结果反馈，0-不准确，1-准确

响应示例

{
    "result":{
        "msg":"操作成功。",
        "code":"0",
        "data":{
            "alarms":[
                {
                    "alarmId":"1726360834259136",
                    "name":"TP1S-1842",
                    "localDate":"2020-10-22 15:14:02",
                    "type":"1",
                    "thumbUrl":"https://openapi.example.com/placeholder/alarm-image.jpg",
                    "deviceId":"TESTQWERXXXX",
                    "picurlArray":[
                        "https://openapi.example.com/placeholder/alarm-image.jpg"
                    ],
                    "channelId":"0",
                    "token":"07540ab39e82488490b232977c333c9e",
					"aiCopyWriting":"穿黑衣服的男子从门店骑车经过",
					"securityRiskLevel":1,
					"aiTag":["人","车"]
                },
                {
                    "alarmId":"1726360340019392",
                    "name":"TP1S-1842",
                    "localDate":"2020-10-22 15:12:01",
                    "type":"1",
                    "thumbUrl":"https://openapi.example.com/placeholder/alarm-image.jpg",
                    "deviceId":"TESTQWERXXXX",
                    "picurlArray":[
                        "https://openapi.example.com/placeholder/alarm-image.jpg"
                    ],
                    "channelId":"0",
                    "token":"ccea3589e6484646b0bc9f97f45dd8c5",
					"aiCopyWriting":"一辆红色汽车从门口经过",
					"securityRiskLevel":1,
					"aiTag":["车"]
                }
            ],
            "count":2,
            "nextAlarmId":1726360340019392
        }
    },
    "id":"9f05aa70-91fd-4d35-8b06-cd2ece55346b"
}

错误码

本接口可能返回下列码；完整分组见错误码。

网关与鉴权（SN / TK / OP）

错误码	错误码说明	下一步
`SN1001`	签名异常	按签名核对 `sign`
`TK1002`	token 无效或过期	重新获取 token
`OP1002`	缺少必填参数	补必填字段
`OP1003`	参数不合法	按本页参数表核对
`OP1039`	分钟级限流	等到下一分钟再试
`OP1040`	调用超限	降低频率
`DV1007`	设备离线或超时	等设备上线

子账号（SUB）

错误码	错误码说明	下一步
`SUB1001`	子账号无指定权限	在子账号策略中补权限
`SUB1002`	子账号无任何设备权限	授权设备或调整策略
`SUB1005`	子账号 token 过期	重新获取子账号 token
`SUB1006`	子账号与设备无授权关系	核对 `Resource` 与设备序列号
`SUB1008`	子账号未绑定当前应用	先创建并绑定子账号
`SUB1007`	创建子账号失败	核对参数后重试
`SUB1009`	子账号创建失败，账号格式错误	`account` 须为手机号或邮箱
`SUB1010`	子账号创建失败，账号已存在	勿重复绑定同一子账号到应用

更多见错误码 · SUB。

告警与消息（DV20xx）

错误码	错误码说明	下一步
`DV2001`	`propertyId` / `serviceId` / `eventId` 非法或不在能力目录；或 `alarmId` 不存在/未映射	查告警时 `msgType` 用目录 eventId；`detail` 的 `alarmId` 须来自同账号 list/search 翻页
`DV2007`	`channelId` 与 `scope` 不符	通道级必传，设备级不传
`DV2009`	`productId` 与设备实际型号不一致	去掉 `productId` 或改成实际型号
`DV2011`	无该能力权限	见权限码。list / search 按条过滤无权事件，不因此整单失败
`DV2012`	设备不存在	核对序列号
`DV2013`	设备未绑定	先绑定

说明

子账号 token 须具备最小权限：Permission 为 Alarm，Resource 为 cam:{deviceId}:{channelId}。配置见权限码。