创建权限模板 - createPermissionTemplate
功能介绍
创建权限模板
授权信息
当前API调用无需身份策略权限。
URI
POST /koodrive/ose/v1/permission/template/create
请求参数
参数 | 是否必选 | 参数类型 | 描述 |
|---|---|---|---|
Authorization | 是 | String | 格式“Bearer {app_access_token}”，需传入应用级token，用于应用服务端调用，通过创建应用时获得的clientid及clientSecret调用接口获取 |
X-User-Id | 是 | String | 用户id，用于app鉴权 |
X-Date | 是 | String | 日期，用于app鉴权 |
Host | 否 | String | 地址，用于app鉴权 |
参数 | 是否必选 | 参数类型 | 描述 |
|---|---|---|---|
name | 是 | String | 权限模板的名称。长度大于0，小于等于8个中文或24个英文/数字。 |
description | 否 | String | 权限模板的描述信息。长度大于0，小于等于50。 |
type | 是 | Integer | 权限模板的类型；0是预置模板，1是自定义模板。 |
company | 是 | String | 权限模板归属的企业。可以是orgid，也可以是appid。 |
capabilities | 是 | Capabilities object | 各种权限值；ControlService需要转换成最终权限的十进制入库 |
参数 | 是否必选 | 参数类型 | 描述 |
|---|---|---|---|
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无权限。 |
响应参数
状态码：200
参数 | 参数类型 | 描述 |
|---|---|---|
code | Integer | 响应码 |
msg | String | 响应消息 |
data | PermissionTemplate object | 权限模板信息 |
参数 | 参数类型 | 描述 |
|---|---|---|
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 | 权限值。 |
参数 | 参数类型 | 描述 |
|---|---|---|
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/create
{
"company" : "*****",
"name" : "****",
"templateType" : 1,
"description" : "",
"capabilities" : {
"listChildNodePermission" : true,
"viewPermission" : false,
"editPermission" : false,
"uploadPermission" : false,
"downloadPermission" : false,
"shareFilePermission" : false,
"removeChildNodePermission" : false,
"copyPermission" : false,
"renameFilePermission" : false,
"deletePermission" : false,
"addChildNodePermission" : false
}
} 响应示例
状态码：200
创建模板响应体
{
"data" : {
"id" : "1590******52215169",
"name" : "*****",
"description" : "",
"templateType" : 1,
"status" : 0,
"company" : "*****",
"createTime" : "2025-01-03T07:56:29.450Z",
"updateTime" : "2025-01-03T07:56:29.450Z",
"capabilities" : {
"addChildNodePermission" : false,
"copyPermission" : false,
"deletePermission" : false,
"downloadPermission" : false,
"editPermission" : false,
"listChildNodePermission" : true,
"removeChildNodePermission" : false,
"renameFilePermission" : false,
"shareFilePermission" : false,
"uploadPermission" : false,
"viewPermission" : false
}
},
"code" : 0,
"msg" : "成功"
} 状态码
状态码 | 描述 |
|---|---|
200 | 创建模板响应体 |
