searchAiAlarmMessageByPage（根据关键词智能搜索报警消息）

searchAiAlarmMessageByPage：根据关键词智能搜索报警消息

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

根据关键词，AI智能搜索匹配的报警事件。需要设备通道开通智见云存储或AI智见套餐才可用。

请求参数

参数名	参数类型	是否必填	默认值	合法值	参数说明
token	String	是			管理员或者子账号accessToken
productId	String	否		可通过listDeviceDetailsByIds、listDeviceDetailsByPage获取	设备产品id，查询子设备消息时必填
deviceId	String	是			设备序列号
channelId	String	是			通道号
nextIndexId	String	否			智能索引ID，用于分页查询。查询第一页时不传，查询第二页往后时必传
beginTime	String	否			开始时间，yyyy-MM-dd HH:mm:ss（智能搜索第一页时必传，第二页往后可以不传，平台会以查第一页时的参数为准）
endTime	String	否			结束时间，yyyy-MM-dd HH:mm:ss（智能搜索第一页时必传，第二页往后可以不传，平台会以查第一页时的参数为准）
searchContent	String	否			搜索关键词，示例：“穿黑衣服的男子”。最大长度50（智能搜索第一页时必传，第二页往后可以不传，平台会以查第一页时的参数为准）
pageSize	String	否	32		分页查询数量，最大32，不传默认32
sortType	String	否			排序方式，0：按照报警事件相似度降序；1：按照时间正序；2：按照时间倒序; 不填，默认按照相似度排序

请求示例

{
    "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",
        "nextIndexId":"",
        "beginTime":"2020-10-22 00:00:00",
        "endTime":"2020-10-22 23:59:59",
		"searchContent":"穿黑衣服的男子",
        "pageSize":"10",
		"sortType":"0"
    }
}

响应字段

字段名			字段类型	字段说明
nextIndexId			Long	索引ID，提高查询速度。用于查询下一页时作为请求参数使用
alarms	token		String	消息唯一标识，用于查询云录像
	channelName		String	通道名称
	alarmId		String	消息Id
	localDate		String	报警时设备本地时间
	alarmType		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字）
	securityRiskLevel		Integer	报警事件安全风险等级，范围1~10
	aiTag		String[]	AI分析的报警事件标签集合，包括人、车、宠物、包裹
	resemblance		Double	相似度分数,范围[0,1]
	feedback	type	String	检测类型，1-人形检测；2-人脸识别；3-大模型检测
	feedback	result	String[]	AI分析的结果反馈，0-不准确，1-准确

响应示例

{
    "result":{
        "msg":"操作成功。",
        "code":"0",
        "data":{
            "alarms":[
                {
                    "alarmId":"1726360834259136",
                    "channelName":"TP1S-1842",
                    "localDate":"2020-10-22 15:14:02",
                    "alarmType":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":["人","车"],
                    "resemblance":0.1783357752858043
                },
                {
                    "alarmId":"1726360340019392",
                    "channelName":"TP1S-1842",
                    "localDate":"2020-10-22 15:12:01",
                    "alarmType":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":["车"],
                    "resemblance":0.1783357752858043
                }
            ],
            "nextIndexId":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}。配置见权限码。