权限码
权限码
子账号 token、管理员操作被分享设备，不是「查得到列表就能写」。权限按一组能力授权，不按 HTTP 条数拆。
device.capability.list 不按权限裁清单：被分享的设备也能看到有哪些项。set / invoke / 消息详情无权时返回 DV2011。消息 列表/检索按条过滤无权事件，不因此整单 DV2011。
实时推送在 推送配置（setMessageCallback）配置，与子账号 Alarm 策略及 device.message.* 查询权限相互独立。历史回调 msgType 见 事件消息类型定义。
各方法页写该条的最小权限。授权接口见 添加子账号权限。完整子账号码表见 账号与授权 API · 概述。
三种 token
| 谁在调 | 能操作哪些设备 | 要不要填权限码 |
|---|---|---|
| 管理员 token | 自己绑定的设备，以及别人分享过来的设备 | 绑定：不需要。被分享：需要该能力对应的权限，见下节 |
| 子用户 token | 该用户自己绑定的设备 | 不需要 |
| 子账号 token | 管理员授权给该子账号的设备 | 需要。码和资源见下节 |
子账号权限码
完整码见 账号与授权 API · 概述 与子账号相关接口页。设备能力里常用：
| 权限码 | 典型能力 |
|---|---|
Alarm | 控制台「报警消息权限」策略别名。device.message.list / search / detail / delete 按条用事件所属能力目录行的 shareAuthCode / subAccountAuthCode 过滤（常与该能力配置同属 Config 等），不是只核对子账号是否勾选 Alarm |
Config | detection.*、成像、灯光、音频、网络、电源、隐私、系统、算法包、媒体配置；ptz.preset、ptz.cruise、ptz.zoom；record.plan |
Ptz | ptz.aim、ptz.linkage |
Talk | 呼叫（call.*） |
RecordReplay | record.file |
Format | storage.local |
Upgrade | device.upgrade.execute / process（和系统域里升级状态用的 Config 不是同一个权限码） |
Capture、Real、DevControl 仍按子账号功能说明授权。标准能力行不用这几个码。
资源写法
只用于子账号授权策略，管理员 / 子用户不填。
| 资源类型 | 写法 | 例子 |
|---|---|---|
| 设备 | dev:序列号 | dev:TESTIPC000012345 |
| 通道 | cam:序列号:通道号 | cam:TESTIPC000012345:0 |
通道资源隶属于设备资源：授权了某台设备的某项权限，该设备下通道默认带上同一权限。写法细则见 账号与授权 API · 概述 与 添加子账号权限。
各功能页写了该组的权限码。各项见 能力使用。
被分享设备的权限
管理员操作别人分享过来的设备时，按业务权限判断。各方法页写「需要××权限」。分享关系在控制台按下列名称勾选。本文档不列出分享接口的功能串。
| 权限 | 用在哪 |
|---|---|
| 实时预览权限 | 查看实时视频 |
| 云台权限 | 云台转动、枪球联动（ptz.aim、ptz.linkage） |
| 对讲权限 | 呼叫与对讲（call.*） |
| 本地录像查看权限 | 本地录像档案（record.file） |
| 云录像查看权限 | 云录像回放与查看 |
| 云录像管理权限 | 云录像的管理操作 |
| 基础配置权限 | 检测、图像、灯光、音频、网络、隐私、系统等配置；预置点、巡航、变焦、录像计划 |
| 高级配置权限 | 比基础配置更严的配置写入 |
| 报警消息权限 | 消息查询、单条查询和删除 |
| 存储管理权限 | 本地存储（storage.local） |
| 设备升级权限 | device.upgrade.execute / process |
子账号授权仍用上一节的规范码，与上表不是同一套写法。
和能力列表的关系
| 现象 | 含义 |
|---|---|
列表里有，set 报 DV2011 | token 对该能力无权限。子账号补授权；管理员核对该设备是绑定还是被分享 |
列表里有，set 报 DV2005 | 该项只读，不是权限问题 |
管理员 token 操作自有绑定设备仍 DV2011 | 少见；先核对该条方法页上的最小权限 |