文档首页/ 云空间服务 KooDrive/ API参考/ API/ 权限模板/ 根据权限模板id数组查询权限模板详情
更新时间:2025-03-14 GMT+08:00

根据权限模板id数组查询权限模板详情

功能介绍

根据权限模板id数组查询权限模板详情

URI

POST /koodrive/ose/v1/permission/template/batchGet

请求参数

表1 请求Header参数

参数

是否必选

参数类型

描述

Authorization

String

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

X-User-Id

String

用户id,用于app鉴权

X-Date

String

日期,用于app鉴权

Host

String

地址,用于app鉴权

表2 请求Body参数

参数

是否必选

参数类型

描述

ids

Array of longs

权限模板id数组,1<=size<=200,size>0时要校验各个id的合法性,如id是否存在等

响应参数

状态码:200

表3 响应Body参数

参数

参数类型

描述

code

Integer

响应码

msg

String

响应信息

data

Array of PermissionTemplate objects

权限模板信息列表

表4 PermissionTemplate

参数

参数类型

描述

id

String

权限模板的唯一id。

name

String

权限模板的名称。

description

String

权限模板的描述信息。

templateType

Integer

权限模板的类型;0是预置模板,1是自定义模板。

status

Integer

权限模板的状态;0是禁用,1是启用。

company

String

权限模板归属的企业。可以是orgid,也可以是appid。

createTime

String

权限模板的创建时间。

updateTime

String

权限模板的更新时间。

capabilities

Capabilities object

权限值。

表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/template/batchGet

{
  "ids" : [ "1590626552448551681" ]
}

响应示例

状态码:200

响应体

{
  "data" : [ {
    "id" : "******",
    "name" : "可见预览下载分享",
    "description" : "可见列表、预览、下载、分享",
    "templateType" : 1,
    "status" : 1,
    "company" : "*******",
    "createTime" : "2024-12-19T07:59:34.032Z",
    "updateTime" : "2024-12-19T07:59:57.786Z",
    "capabilities" : {
      "addChildNodePermission" : false,
      "copyPermission" : false,
      "deletePermission" : false,
      "downloadPermission" : true,
      "editPermission" : false,
      "listChildNodePermission" : true,
      "removeChildNodePermission" : false,
      "renameFilePermission" : false,
      "shareFilePermission" : true,
      "uploadPermission" : false,
      "viewPermission" : true
    }
  } ],
  "code" : 0,
  "msg" : "success"
}

状态码

状态码

描述

200

响应体