开发者平台

TP-LINK官网首页
开发者平台 / 视频管理系统(VMS)/ API功能接口定义 / 用户管理

4.1.9 获取角色的详细信息

接口说明:

名称

内容

URL

https://xxx/tums/account/v1/getRoleInfo

功能说明

获取角色的详细信息

使用限制

需要用户管理权限

请求参数:

参数名称

参数描述

roleId

int

角色的ID

返回参数

参数名称

参数描述

result

List

roleId

int

角色ID

roleName

String

角色名

sysDefault

bool

是否为系统默认角色

projectList

List

关联的项目信息,包含项目ID和项目名称

menuList

List

角色可入功能菜单的列表,包含菜单ID和菜单名称

previewRegions

List

角色可预览的区域(可选),包含区域ID列表

previewDevices

List

角色可预览的设备(可选),包含设备ID列表,优先级低于区域预览权限

playbackRegions

List

角色可回放的区域(可选),包含区域ID列表

playbackDevices

List

角色可回放的设备(可选),包含设备ID列表,优先级低于区域预览权限

error_code

返回码,0 – 成功,其他- 失败,具体请参考返回码章节

-80122

角色不存在

代码示例

          https://xxx/tums/account/v1/getRoleInfo
          request:
          {
            "roleId": 2
          }
          response:
          {
              "result": {
                  "roleId": 2,
                  "roleName": "roleModel",
                  "description": "test add role",
                  "sysDefault": 0,
                  "projectList": [
                      {
                          "projectId": "1",
                          "projectName": "管理中心"
                      }
                  ],
                  "previewRegions": [
                      7, 8, 9
                  ],
                  "previewDevices": [
                      "2", "3"
                  ],
                  "playbackRegions": [
                      10, 11
                  ],
                  "playbackDevices": [
                      "4", "5", "6"
                  ]
              },
              "error_code": 0
          }