unBindDevice(解绑设备)
unBindDevice:解绑设备
要点:https://openapi.lechange.cn/openapi/unBindDevice · 见 错误码
将账号下指定设备解绑。
请求参数
| 参数名 | 参数类型 | 是否必填 | 默认值 | 合法值 | 参数说明 |
|---|---|---|---|---|---|
| token | String | 是 | 管理员accessToken | ||
| deviceId | String | 是 | 设备序列号 | ||
| productId | String | 否 | 可通过listDeviceDetailsByIds、listDeviceDetailsByPage获取 | 设备产品id,解绑 子设备 时必填 | |
| subDeviceId | String | 否 | 可通过listDeviceDetailsByIds、listDeviceDetailsByPage获取 | 子设备序列号,解绑 子设备 时必填 | |
| deleteCloudRecords | String | 否 | retain | delete / retain | 是否删除云录像片段;未传视为 retain |
| deleteCloudAlarms | String | 否 | 国内 delete | delete / retain | 是否删除告警消息;国内未传默认删 |
| deleteCloudStorage | String | 否 | delete | delete / retain | 是否解绑云存储套餐;未传或 delete 时回退套餐 |
| deleteDeviceLink | String | 否 | delete | delete / retain | 是否删除与 NVR 等设备的物理链接 |
请求示例
{
"system":{
"ver":"1.0",
"appId":"lcdxxxxxxxxx",
"sign": "xjhCQBoJ9hRDsCjyDcHjtDNzRZ3ZJezcawsfWeiaoxU=",
"time":1603352767,
"nonce":"bd596cc6-08a6-4b50-9359-f361640a84b2"
},
"id":"e865b28c-7681-43a6-8d20-27659f3ef572",
"params":{
"deviceId":"TESTQWERXXXX",
"token": "<yourAccessToken>"
}
}
响应字段
无data数据返回
响应示例
{
"result":{
"msg":"操作成功。",
"code":"0"
},
"id":"e865b28c-7681-43a6-8d20-27659f3ef572"
}
错误码
本接口可能返回下列码;完整分组见 错误码。
网关与鉴权(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)
| 错误码 | 错误码说明 | 下一步 |
|---|---|---|
DV1001 | 已被其他账号绑定 | 解绑或换设备 |
DV1002 | 设备不存在 | 核对序列号 |
DV1003 | 已被当前账号绑定 | 无需重复绑定 |
DV1005 | 验证码 / SC 码错误 | 核对设备机身码 |
DV1008 | 绑定数量超限 | 解绑冗余设备 |
DV1011 | 设备未绑定 | 先执行绑定 |
DV1013 | 注册超 3 天须局域网绑定 | 设备与客户端同网或重启设备 |
DV1014 | 绑定错误过频(30 分钟) | 等待解锁 |
DV1015 | 绑定错误过频(24 小时) | 等待解锁 |
DV1029 | 设备已被绑定 | 勿重复绑定 |
DV1033 | 已被他人绑定 | 联系绑定方 |
DV1055 | 非开放平台绑定设备 | 走开放平台绑定流程 |
DV1059 | 第三方平台已绑定 | 先解除第三方绑定 |
更多见 错误码 · DV。
说明
仅支持管理员 accessToken;子账号不可调用本接口。解绑副作用与可选参数默认行为见 查询、改名与解绑设备 解绑小节。