queryCloudRecordPlan(获取设备上的连续云存储录像计划)
queryCloudRecordPlan:获取设备上的连续云存储录像计划
要点:https://openapi.lechange.cn/openapi/queryCloudRecordPlan · 见 错误码
获取设备上的连续云存储录像计划。
请求参数
| 参数名 | 参数类型 | 是否必填 | 默认值 | 合法值 | 参数说明 |
|---|---|---|---|---|---|
| token | String | 是 | 管理员accessToken | ||
| deviceId | String | 是 | 设备序列号 | ||
| channelId | String | 是 | 通道号;IoT 设备鉴权后服务层可能按 0 处理 | ||
| deviceCloudId | String | 否 | 待查询计划的设备云存储唯一ID,可通过deviceCloudList:查询设备通道下所有云存储服务 获取值。不填默认查询当前使用中的连续云存储计划 |
请求示例
{
"id":"d5c287b4-5b2f-4f03-baf5-8032c5c354af",
"system":{
"ver":"1.0",
"appId":"lcdxxxxxxxxx",
"sign": "xjhCQBoJ9hRDsCjyDcHjtDNzRZ3ZJezcawsfWeiaoxU=",
"time": 1706511734,
"nonce": "f5a1ae2d-c09c-4d39-a744-83a5c2c653c2"
},
"params":{
"token": "<yourAccessToken>",
"deviceId":"TESTQWER123456",
"channelId": "0",
"deviceCloudId":"206612"
}
}
响应字段
| 字段名 | 字段类型 | 字段说明 | |
|---|---|---|---|
| deviceId | String | 设备序列号 | |
| channelId | String | 通道号 | |
| productId | String | 产品 ID(部分设备返回) | |
| dailyAvailableHours | Integer | 套餐每日可用录像时长(小时);无连续套餐或计划为空时可能为默认/0 | |
| upstream | Integer | 上行带宽相关配置,默认 **8** | |
| limitTime | Integer | 每日计划上限小时数,默认 **24** 或库表值 | |
| rules | period | String | 云录像计划周期,Monday,Tuesday,Wednesday,Thursday,Friday,Saturday,Sunday |
| beginTime | String | 云录像计划开始时间,HH:mm:ss格式 | |
| endTime | String | 云录像计划结束时间,HH:mm:ss格式 | |
| type | Integer | 计划类型:**1** 实时 / **2** 定时 | |
| stream | String | 码流标识(可选) | |
| pullTime | String | 拉流时间(可选) | |
响应示例
{
"id":"d5c287b4-5b2f-4f03-baf5-8032c5c354af",
"result":{
"code":"0",
"msg":"操作成功",
"data": {
"deviceId":"TESTQWER123456",
"channelId": "0",
"dailyAvailableHours": 12,
"rules":[
{
"period": "Monday,Tuesday,Wednesday,Thursday,Friday",
"beginTime": "08:00:00",
"endTime": "18:00:00"
},
{
"period": "Saturday,Sunday",
"beginTime": "10:00:00",
"endTime": "17:00:00"
}
]
}
}
}
错误码
本接口可能返回下列码;完整分组见 错误码。
网关与鉴权(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。
设备访问与通道(DV10xx)
| 错误码 | 错误码说明 | 下一步 |
|---|---|---|
DV1007 | 设备离线或超时 | 等设备上线;低电休眠先 唤醒 |
DV1009 | 设备正忙 | 稍后重试 |
DV1012 | 分享/授权设备权限不足 | 核对子账号 Permission / Resource |
DV1019 | 能力集不支持 | 确认型号与 设备能力 |
DV1020 | 通道离线 | 检查通道与设备状态 |
DV1026 | 不支持此功能 | 换接口或升级固件 |
DV1028 | 未绑定或通道不存在 | 核对 deviceId / channelId |
DV1030 | 设备休眠 | 唤醒后再调 |
DV1057 | 通道不存在 | 核对通道号 |
DV1061 | 设备响应超时 | 检查设备网络 |
DV1062 | 需先唤醒设备 | 调用唤醒接口 |
DV1069 | 不满足操作条件 | 见 msg |
云存储套餐(ST)
| 错误码 | 错误码说明 | 下一步 |
|---|---|---|
ST1001 | 默认云存储套餐已到期 | 续费或换套餐 |
ST1002 | 无默认云存储套餐 | 先开通套餐 |
ST1004 | 云存储未开通 | 开通云存储 |
ST1005 | 云存储已过期 | 续费 |
ST1006 | 套餐不存在 | 核对套餐 id |
ST1009 | 仍有未过期收费套餐 | 先处理旧套餐 |
ST1010 | 设备不支持该套餐策略 | 换支持的套餐 |
ST1011 | 24 小时内仅可解绑一次 | 次日再试 |
OP1043 | 国标设备仅支持连续云存储 | 换连续套餐 |
OP1046 | 套餐不属于该设备 | 核对设备与套餐 id |
更多见 错误码 · ST。
说明
仅支持管理员 accessToken;子账号不可调用本接口。未指定或无效的 deviceCloudId 可能返回空 rules 或错误码 OP1046(见云存储错误码片段)。无连续云存储套餐时 rules 可能为空数组。