# 创建权限模板 - createPermissionTemplate
#### 功能介绍
创建权限模板
#### 授权信息
当前API调用无需身份策略权限。
#### URI
POST /koodrive/ose/v1/permission/template/create
#### 请求参数
表1请求Header参数 
| 参数            | 是否必选 | 参数类型   | 描述                                                                                        |
|:---|:---|:---|:---|
| Authorization | 是    | String | 格式"Bearer {app_access_token}"，需传入应用级token，用于应用服务端调用，通过创建应用时获得的clientid及clientSecret调用接口获取 |
| X-User-Id     | 是    | String | 用户id，用于app鉴权                                                                              |
| X-Date        | 是    | String | 日期，用于app鉴权                                                                                |
   
表2请求Body参数 
| 参数           | 是否必选 | 参数类型                                                                   | 描述                                  |
|:---|:---|:---|:---|
| name         | 是    | String                                                                 | 权限模板的名称。长度大于0，小于等于8个中文或24个英文/数字。    |
| description  | 否    | String                                                                 | 权限模板的描述信息。长度大于0，小于等于50。             |
| type         | 是    | Integer                                                                | 权限模板的类型；0是预置模板，1是自定义模板。             |
| company      | 是    | String                                                                 | 权限模板归属的企业。可以是orgid，也可以是appid。       |
| capabilities | 是    | [Capabilities] object | 各种权限值；ControlService需要转换成最终权限的十进制入库 |
   
 表3Capabilities 
| 参数                        | 是否必选 | 参数类型    | 描述                             |
|:---|:---|:---|:---|
| 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**
表4响应Body参数 
| 参数   | 参数类型                                                                                | 描述     |
|:---|:---|:---|
| code | Integer                                                                             | 响应码    |
| msg  | String                                                                              | 响应消息   |
| data | [PermissionTemplate] object | 权限模板信息 |
   
 表5PermissionTemplate 
| 参数           | 参数类型                                                                    | 描述                            |
|:---|:---|:---|
| 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 | 权限值。                          |
   
 表6Capabilities 
| 参数                        | 参数类型    | 描述                             |
|:---|:---|:---|
| 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 | 创建模板响应体 |