获取用户权限列表 - 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	格式“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" : "成功"
}