setLocalRecordPlan(设置本地录像计划)
setLocalRecordPlan:设置本地录像计划
请求格式
遗留 HTTP 保留: 新接入可使用 存储计划(
record.plan.plan)对应能力。两套接口不是一对一替代。 registry 登记的是setLocalRecordPlanRules,不是本方法。
功能详情
设置设备本地录像计划,在录像计划时间段内,设备会全量采集视频数据到到设备本地存储中。
备注:
1、需要设备具备LocalRecord能力集才支持设备本地录像配置
2、默认不设置录像计划的情况下,设备只会存储设备告警事件关联的录像数据
请求地址
https://openapi-[DataCenter].easy4ip.com/openapi/setLocalRecordPlan
传入参数说明
| 参数名 | 参数类型 | 是否必填 | 默认值 | 合法值 | 参数说明 |
|---|---|---|---|---|---|
| token | String | 是 | 管理员accessToken | ||
| deviceId | String | 是 | 设备序列号 | ||
| channelId | String | 是 | 通道号 | ||
| beginTime | String | 是 | HH:mm:ss | 开始时间 | |
| endTime | String | 是 | HH:mm:ss,注意结束时间必须大于等于开始时间 | 结束时间 | |
| period | String | 是 | 可以为"Monday, Tuesday, Wednesday, Thursday, Friday, Saturday, Sunday",利用逗号分隔同时设置多个周期 | 录像周期 |
样例输入
{
"id":"d5c287b4-5b2f-4f03-baf5-8032c5c354af",
"system":{
"ver":"1.0",
"appId":"lcdxxxxxxxxx",
"sign": "xjhCQBoJ9hRDsCjyDcHjtDNzRZ3ZJezcawsfWeiaoxU=",
"time":1599031074,
"nonce":"8ec8a7bd1d1c95420de20d92422d457d"
},
"params":{
"token":"At_00006acr3456d12312d3grf60147de7ec",
"deviceId":"TESTQWERXXXX",
"channelId":"0",
"beginTime":"00:00:00",
"endTime":"23:59:59",
"period":"Monday,Tuesday,Wednesday,Thursday,Friday,Saturday,Sunday"
}
}
返回data字段说明
无data数据返回
样例输出
{
"result":{
"msg":"操作成功.",
"code":"0"
},
"id":"d5c287b4-5b2f-4f03-baf5-8032c5c354af"
}
错误码
网关与鉴权(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。
本地录像计划冲突(YL)
| 错误码 | 错误码说明 | 下一步 |
|---|---|---|
YL1001 | 拉取时间点落在定时录像计划内 | 调整拉取时间 |
| :--- | :--- | :--- |
YL1002 | 定时计划时间重合 | 修改计划时段 |
| :--- | :--- | :--- |
YL1003 | 存在有效云存储录像计划 | 先关闭云存储计划 |
| :--- | :--- | :--- |
YL1004 | 存在有效动检计划 | 先关闭动检计划 |
| :--- | :--- | :--- |
YL1005 | 需支持计划的云存储套餐 | 换连续云存储套餐 |
更多见 错误码 · YL。
说明
支持管理员 accessToken。本接口属于旧版协议;新集成请优先使用 本地录像计划 等现行接口。
