getAlarmMessageById（根据 id 查询告警详情）
getAlarmMessageById：根据 id 查询告警详情
遗留 HTTP 保留： 新接入可使用 告警消息（
device.message.detail）对应能力。两套接口不是一对一替代。device.message.*只是相关入口，不是本 HTTP 的一对一替代。
功能说明
根据 alarmId 查询告警消息详情。
遗留 OpenAPI 单条查询。能力事件见 查询单条告警（
device.message.detail）。
请求地址
https://openapi-[DataCenter].easy4ip.com/openapi/getAlarmMessageById
请求格式
子账号 token 最低权限
"Permission":"Alarm" "Resource":"cam:serial number:channel number"
请求参数
| 参数名 | 参数类型 | 是否必填 | 默认值 | 合法取值 | 参数说明 |
|---|---|---|---|---|---|
| token | String | 是 | 管理员或子账号 accessToken | ||
| deviceId | String | 是 | 设备序列号 | ||
| channelId | String | 是 | 通道号 | ||
| alarmId | String | 是 | 告警消息 Id | ||
| msgType | String | 是 | 消息类型 |
请求示例
{
"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":"At_00000ad9e6e87f0142eb92e207aec46a"
}
}
返回 data 字段
| 字段名 | 字段类型 | 字段说明 |
|---|---|---|
| time | Long 或 String | 告警时间（UNIX 秒或设备本地时间字符串，因机型而异） |
| channelId | String | 通道号 |
| alarmId | Long 或 String | 消息 Id |
| deviceId | String | 设备序列号 |
| picurlArray | String[] | 告警图片 URL |
| thumbUrl | String | 缩略图 URL |
| msgType | String | 消息类型（如 videoMotion、alarmPIR） |
| token | String | 云录像 token（cloudToken，若有） |
响应示例
{
"result":{
"msg":"操作成功.",
"code":"0",
"data":{
"msgType":"videoMotion",
"alarmId":1726360834259136,
"time":"20201022T151402",
"thumbUrl":"https://example-cloud.example.com/alarm/thumb.jpg?Expires=1603438169&OSSAccessKeyId=PLACEHOLDER&Signature=PLACEHOLDER",
"picurlArray":[
"https://example-cloud.example.com/alarm/0.jpg?Expires=1603438169&OSSAccessKeyId=PLACEHOLDER&Signature=PLACEHOLDER"
],
"deviceId":"TESTQWERXXXX",
"channelId":"0",
"token":"07540ab39e82488490b232977c333c9e"
}
},
"id":"28ca89f4-10c9-4ac4-9215-b829072eedcf"
}
错误码
网关与鉴权（SN / TK / OP）
| 错误码 | 错误码说明 | 下一步 |
|---|---|---|
SN1001 | 签名校验异常 | 按 HTTP 开发规范 核对 sign |
TK1002 | token 无效或过期 | 重新获取 accessToken |
OP1002 | 缺少必填参数 | 补必填字段 |
OP1003 | 参数不合法 | 按本页参数表核对 |
OP1009 | 权限不足 | 核对 token 与设备绑定/分享权限 |
OP1013 | 接口总次数超限 | 降低调用频率 |
OP1014 | 接口日限额超限 | 见 接口调用限额 |
DV1007 | 设备离线 | 等设备上线 |
更多见 错误码 · OP/SN/TK。
子账号（SUB）
| 错误码 | 错误码说明 | 下一步 |
|---|---|---|
SUB1001–SUB1002 | 子账号无接口权限 | 在 addPolicy 中补策略 |
SUB1005 | 子账号 token 过期 | 重新 subAccountToken |
SUB1006 | 子账号与设备无授权 | 核对 Resource 与设备序列号 |
SUB1008 | 子账号未绑定应用 | 先创建并绑定子账号 |
更多见 错误码 · SUB。
设备访问与通道（DV10xx）
| 错误码 | 错误码说明 | 下一步 |
|---|---|---|
DV1007 | 设备离线或超时 | 等设备上线 |
DV1009 | 设备正忙 | 稍后重试 |
DV1012 | 分享/授权设备权限不足 | 核对子账号 Permission / Resource |
DV1019 | 能力集不支持 | 确认型号与能力列表 |
DV1020 | 通道离线 | 检查通道状态 |
DV1026 | 不支持此功能 | 换接口或升级固件 |
DV1028 | 未绑定或通道不存在 | 核对 deviceId / channelId |
更多见 错误码 · DV。