addPolicy(添加子账号权限)
addPolicy:添加子账号权限
URL:https://openapi.lechange.cn/openapi/addPolicy
公共请求体与签名:见 调用约定、签名。请求体 params.token 为管理员 accessToken(子账号类方法可用子账号 token,见各页说明)。
添加子账号权限
请求参数
| 参数名 | 参数类型 | 是否必填 | 默认值 | 合法值 | 参数说明 |
|---|---|---|---|---|---|
| openid | String | 是 | 子账号ID | ||
| policy | Object | 是 | 子账号权限策略。单次请求最多 10 条 statement,且所有 statement 内 resource 条目合计不超过 10 个(dev/cam/iot 资源串计数) | ||
| token | String | 是 | 管理员accessToken |
备注:子账号
policy语法见 为我的用户创建子账号并分配设备(Policy/permission/resource);方法索引见 账号与授权。
请求示例
{
"system":{
"ver":"1.0",
"appId":"lcdxxxxxxxxx",
"sign": "xjhCQBoJ9hRDsCjyDcHjtDNzRZ3ZJezcawsfWeiaoxU=",
"time":1603350473,
"nonce":"a4d59add-0f04-4b7e-9355-d1fb4e9dc22b"
},
"id":"d82a7fa7-655f-4bb8-ab75-72bb3dfa3a94",
"params":{
"token": "<yourAccessToken>",
"openid": "5dd2fe5bc11240a9b5d4fd4474c857c5",
"policy": {
"statement": [
{
"permission": "Ptz,Talk,Config",
"resource": [
"dev:469631729",
"cam:544229080:1"
]
},
{
"permission": "Real",
"resource": [
"dev:470686804"
]
}
]
}
}
}
响应字段
无data数据返回
响应示例
{
"id": "123456",
"result": {
"code": "0",
"msg": "操作成功"
}
}
错误码
本接口可能返回下列码;完整分组见 错误码。
网关与鉴权(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。
说明
仅支持管理员 accessToken;子账号不可调用本接口。