文档首页/ 云空间服务 KooDrive/ API参考/ API/ 精细化授权/ 获取用户权限列表 - getUserPermissionList
更新时间：2025-10-21 GMT+08:00
查看PDF
分享

获取用户权限列表 - getUserPermissionList

功能介绍

获取用户权限列表

授权信息

当前API调用无需身份策略权限。

URI

GET /koodrive/ose/v1/permission/userList

表1 Query参数

参数

是否必选

参数类型

描述

templateId

否

String

权限模板id

  • -1：匿名模板

  • 其他：一个命名模板的id

spaceType

是

Integer

空间类型

  • 0：部门

  • 1：群组

groupId

否

String

群组id(空间类型为1必传)

deptId

否

String

部门id(空间类型为0必传)

count

否

Integer

返回数量（最大100）

cursor

否

String

游标，第一次不传（当第二次调时，从第一次返回体中获取，填入即可从第一次最后一个用户的下一个用户开始返回）

containerId

是

String

空间id

userName

否

String

用户名称

fileId

否

String

文件id

请求参数

表2 请求Header参数

参数

是否必选

参数类型

描述

Authorization

是

String

  1. 格式“Bearer {app_access_token}”，需传入应用级token，用于应用服务端调用，通过创建应用时获得的clientid及clientSecret调用接口获取

X-Traceid

否

String

消息日志跟踪标识（必须58位）

language

否

String

国际化语言标识，符合i18n规范，如zh_cn表示简体中文，en_us表示美式英语

X-User-Id

是

String

用户id，用于app鉴权

X-Date

是

String

日期，用于app鉴权

Host

否

String

地址，用于app鉴权

响应参数

状态码：200

表3 响应Body参数

参数

参数类型

描述

userPermissonList

Array of userPermisson objects

用户权限列表

code

String

信息码

msg

String

信息

nextCursor

String

游标
表4 userPermisson

参数

参数类型

描述

userName

String

用户名称

mobile

String

手机号

deptName

String

部门名称

deptId

String

部门id

templateId

String

模板id

groupName

String

群组名称

description

String

匿名模板时返回的具体权限描述

userId

String

用户id

templateName

String

模板名称

deptRole

Integer

部门角色（在传入的deptId下）

groupRole

Integer

群组角色（在传入的group下）

capabilities

Array of Capabilities objects

权限值
表5 Capabilities

参数

参数类型

描述

addChildNodePermission

Boolean

新建文件/文件夹权限；true有权限，false无权限。

copyPermission

Boolean

复制权限；true有权限，false无权限。

deletePermission

Boolean

删除权限；true有权限，false无权限。

downloadPermission

Boolean

下载权限；true有权限，false无权限。

editPermission

Boolean

编辑权限；true有权限，false无权限（暂不支持编辑）。

listChildNodePermission

Boolean

可见列表权限；true有权限，false无权限。

removeChildNodePermission

Boolean

移动权限；true有权限，false无权限。

renameFilePermission

Boolean

重命名权限；true有权限，false无权限。

shareFilePermission

Boolean

分享权限；true有权限，false无权限。

uploadPermission

Boolean

上传权限；true有权限，false无权限。

viewPermission

Boolean

预览权限；true有权限，false无权限。

请求示例

获取用户权限列表请求示例

/koodrive/ose/v1/permission/userList?spaceType=0&deptId=1570902*****4673&count=100&containerId=IAAFW*******054209

Authorization:Bearer+7b8d5d009443187d149432249b2482fbc87d1be0c1dd3f6f

响应示例

状态码：200

获取用户权限列表响应

{
  "userPermissionList" : [ {
    "userName" : "111",
    "userId" : "15842******45888",
    "mobile" : "0086137****6060",
    "deptName" : "ce**i-1",
    "templateId" : "1568195451952301579",
    "capabilities" : {
      "addChildNodePermission" : true,
      "copyPermission" : true,
      "deletePermission" : false,
      "downloadPermission" : true,
      "editPermission" : true,
      "listChildNodePermission" : true,
      "removeChildNodePermission" : true,
      "renameFilePermission" : true,
      "shareFilePermission" : true,
      "uploadPermission" : true,
      "viewPermission" : true
    },
    "templateName" : "仅不可删除",
    "deptRole" : 1
  } ],
  "code" : 0,
  "msg" : "成功"
}

状态码

状态码

描述

200

获取用户权限列表响应
父主题： 精细化授权