开发者平台

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

4.1.10 获取角色的详细信息

接口说明:

名称

内容

URL

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

功能说明

获取角色的详细信息

使用限制

需要用户管理权限

请求参数:

参数名称

参数描述

roleId

int

角色的ID(取值范围:不小于2)

返回参数

参数名称

参数描述

result

roleId

int

角色ID

roleName

String

角色名

description

String

角色描述(可选)

sysDefault

bool

是否为系统默认角色,0:否,1:是

projectList

List

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

menuList

List

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

previewRegions

List

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

previewDevices

List

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

playbackRegions

List

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

playbackDevices

List

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

decoderDevices

List

角色可操作的解码器(可选),包含设备ID列表

ptzRegions

List

角色可操作云台的区域(可选),包含区域ID列表

ptzDevices

List

角色可操作云台的设备(可选),包含设备ID列表表

error_code

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

-80122

角色不存在

代码示例

          https://xxx/tums/account/v1/getRoleInfo
          request:
          {
            "roleId": 2
          }
          response:
          {
              "result": {
                  "roleId": 2,
                  "roleName": "roleModel",
                  "description": "testGetole",
                  "sysDefault": 0,
                  "projectList": [
                      {
                          "projectId": "1",
                          "projectName": "管理中心"
                      }
                  ],
                  "menuList":[
                     {
                          "menuId":20,
                          "menuName":"系统设置",
                          "menuUrl":"systemConfig",
                          "sysType":3,
                          "menuType":0
                     },
                     {
                          "menuId":64,
                          "menuName":"子码流预览",
                          "menuUrl":"minorStream",
                          "sysType":0,
                          "menuType":4
                     }
                  ],
                  "previewRegions": [
                      7, 8, 9
                  ],
                  "previewDevices": [
                      "2", "3"
                  ],
                  "playbackRegions": [
                      10, 11
                  ],
                  "playbackDevices": [
                      "4", "5", "6"
                  ],
                  "decoderDevices": [
                      "2", "3"
                  ],
                  "ptzRegions": [
                      10, 11
                  ],
                  "ptzDevices": [
                      "4", "5", "6"
                  ]

              },
              "error_code": 0
          }