getAlarmMessageStatistics（获取设备通道报警统计报表及安全风险报告）

getAlarmMessageStatistics：获取设备通道报警统计报表及安全风险报告

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

查看设备通道每天的AI分析报警报表及安全风险报告。需要设备通道开通智见云存储或AI智见套餐才会有统计报表生成。

请求参数

参数名			参数类型	是否必填	默认值	合法值	参数说明
token			String	是			管理员或子账号 accessToken（子账号见「说明」）
productId			String	否		可通过listDeviceDetailsByIds、listDeviceDetailsByPage获取	设备产品ID，
deviceId			String	是			设备序列号
channelId			String	是			通道号
startDay			String	是			开始时间，yyyyMMdd
endDay			String	是			结束时间，yyyyMMdd
multiView			String	否			对于多目设备，需要传具体目数，示例multiView=2（对应双目设备）。不传或multiView=1表示普通单目摄像头
aiStatisticsAnalysisEnable			Boolean	否	false		ai统计分析标签，已经使用了AI智见套餐或智见云存储则true
msgAnalysis	analysisHourInterval		Integer	否			时间间隔，按小时维度区分。例如传2表示每2小时
	labelTime		Array	否			对象数组；元素字段：`labelType`（String）、`count`（Integer）、`sortType`（`desc`/`asc`）
	riskStatement	startHour		String	否			开始小时，示例：00
	riskStatement	endHour		String	否			结束小时，示例：05

请求示例

{
    "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",
        "startDay": "20260427",
        "endDay": "20260428",
        "aiStatisticsAnalysisEnable": true,
        "msgAnalysis": {
            "analysisHourInterval": 2,
            "labelTime": [{
                "labelType": "petAlarm",
                "count": 10,
                "sortType": "desc"
            }]
        },
        "riskStatement": [{
            "startHour": "00",
            "endHour": "05"
        }]
    }
}

响应字段

字段名			字段类型	字段说明
aiStatisticsAnalysisResult	analysisDay		String	日期，示例：20250227
	riskStatementInfo	startHour	String	开始小时，示例：00
		endHour	String	结束小时，示例：05
		count	String	次数
		riskEventDoc	String	风险事件文案，如“一名穿深色羽绒服的人背对镜头站在办公区”
	msgAnalysisInfo	labelType	String	标签名，如humanAlarm
		alarmDateTimeArr	Array[String]	消息时间数据：yyyy-MM-dd HH:mm:ss
		timeDistribute	Array[int]	时间分布，如[0,0,0,3,0]
statistics	bigModelStatisticsLabels		String	AI检测标签集合
	totalcount		Integer	当天总数
	date		String	日期，示例：20210721
	other		Integer	other（其他检测事件）总数
	abSoundAlarm		Integer	abSoundAlarm（异常音事件）总数
	petAlarm		Integer	petAlarm（宠物检测事件）总数
	carAlarm		Integer	carAlarm（车检测事件）总数
	faceAlarm		Integer	faceAlarm（人脸检测事件）总数
	motionAlarm		Integer	motionAlarm（动检事件）总数
	humanAlarm		Integer	humanAlarm（人形检测事件）总数
	peopleFallAlarm		Integer	peopleFallAlarm（跌倒检测事件）总数
	suspectedPeopleFallAlarm		Integer	suspectedPeopleFallAlarm（疑似跌倒检测事件）总数
	packageAlarm		Integer	packageAlarm(包裹检测事件)总数
	voiceHelpAlarm		Integer	voiceHelpAlarm（语音求助检测事件）总数
	stayoverAlarm		Integer	stayoverAlarm（逗留检测事件）总数
	cryingAlarm		Integer	cryingAlarm（啼哭检测事件）总数
	callAlarm		Integer	callAlarm（呼叫事件）总数

响应示例

{
	"result": {
		"msg": "操作成功。",
		"code": "0",
		"data": {
			"aiStatisticsAnalysisResult": [
				{
					"analysisDay": "20250227",
					"riskStatementInfo": [
						{
							"startHour": "00",
							"endHour": "05",
							"count": 10,
							"riskEventDoc": "一名穿深色羽绒服的人背对镜头站在办公区"
						}
					],
					"msgAnalysisInfo": [
						{
							"labelType": "humanAlarm",
							"alarmDateTimeArr": ["2025-02-27 08:15:00"],
							"timeDistribute": [0,0,0,5,0,2]
						}
					]
				}
			],
			"statistics": [
				{
					"bigModelStatisticsLabels": [],
					"totalcount": 20,
					"date": "20260327",
					"other": 5,
					"abSoundAlarm": 0,
					"petAlarm": 10,
					"carAlarm": 0,
					"faceAlarm": 2,
					"motionAlarm": 3,
					"humanAlarm": 0,
					"peopleFallAlarm": 0,
					"suspectedPeopleFallAlarm": 0,
					"packageAlarm": 0,
					"voiceHelpAlarm": 0,
					"stayoverAlarm": 0,
					"cryingAlarm": 0,
					"callAlarm": 0
				}
			]
		}
	},
	"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}。配置见权限码。