getAlarmMessageById（根据id查询详细的报警消息）

getAlarmMessageById：根据id查询详细的报警消息

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

根据报警消息Id查询报警详情。

请求参数

参数名	参数类型	是否必填	合法值	参数说明
token	String	是		管理员或者子账号accessToken
productId	String	否	可通过listDeviceDetailsByIds、listDeviceDetailsByPage获取	设备产品id，查询子设备消息时必填
deviceId	String	是		设备序列号
subDeviceId	String	否	可通过listDeviceDetailsByIds、listDeviceDetailsByPage获取	子设备序列号，查询子设备消息时必填
channelId	String	是		通道号
alarmId	String	是		告警消息Id
msgType	String	否		Mix 消息类型，建议传入以便路由；省略时平台按 `alarmId` 解析

请求示例

{
    "system":{
        "ver":"1.0",
        "appId":"lcdxxxxxxxxx",
        "sign": "xjhCQBoJ9hRDsCjyDcHjtDNzRZ3ZJezcawsfWeiaoxU=",
        "time":1603351506,
        "nonce":"3e3c27f0-1071-4f55-9de9-f0a932effb48"
    },
    "id":"28ca89f4-10c9-4ac4-9215-b829072eedcf",
    "params":{
        "msgType":"videoMotion",
        "alarmId":"1726360834259136",
        "deviceId":"TESTQWERXXXX",
        "channelId":"0",
        "token": "<yourAccessToken>"
    }
}

响应字段

字段名	字段类型	字段说明
time	String	报警时间，格式yyyyMMdd'T'HHmmss
alarmId	Long	消息Id
deviceId	String	设备ID
channelId	String	通道号
picurlArray	String[]	报警图片url
thumbUrl	String	缩略图Url
msgType	String	消息类型，alarmPIR：人体红外；videoMotion：动态检测；wireLessDevLowPower：低电压告警等
token	String	消息唯一标识，用于查询云录像
aiCopyWriting	String	AI大模型分析文案（10-20字），当设备通道使用智见云存储或AI智见套餐时才有值
securityRiskLevel	Integer	报警事件安全风险等级，范围1~10。当设备通道使用智见云存储或AI智见套餐时才有值
aiTag	String[]	AI分析的报警事件标签集合，包括人、车、宠物、包裹。当设备通道使用智见云存储或AI智见套餐时才有值

响应示例

{
    "result":{
        "msg":"操作成功。",
        "code":"0",
        "data":{
            "msgType":"videoMotion",
            "alarmId":1726360834259136,
            "time":"20201022T151402",
            "thumbUrl":"https://openapi.example.com/placeholder/alarm-image.jpg",
            "picurlArray":[
                "https://openapi.example.com/placeholder/alarm-image.jpg"
            ],
            "deviceId":"TESTQWERXXXX",
            "channelId":"0",
            "token":"07540ab39e82488490b232977c333c9e",
            "aiCopyWriting":"穿黑衣服的男子从门店骑车经过",
            "securityRiskLevel":1,
            "aiTag":["人","车"]
        }
    },
    "id":"28ca89f4-10c9-4ac4-9215-b829072eedcf"
}

错误码

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

网关与鉴权（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}。配置见权限码。