批量授权(单个文件)
标签:文件权限
请求说明
| 字段 | 值 |
|---|---|
请求地址 | https://openapi.wps.cn/v7/drives/{drive_id}/files/{file_id}/permissions/batch_create |
HTTP 方法 | POST |
接口描述 | 批量新建文件权限项。如授权主体已存在时,则会更新相应权限角色。 |
签名方式 | KSO-1 |
限频策略 | 无 |
权限要求 | 查询和管理文件权限(应用授权) kso.file_permission.readwrite查询和管理文件权限(用户授权) kso.file_permission.readwrite |
请求头 (Headers)
| 属性名 | 类型 | 是否必填 | 描述 | 可选值 |
|---|---|---|---|---|
X-Kso-Id-Type | string | 否 | 类型 * internal - 内部 * external - 外部 | internal, external |
路径参数 (Path)
| 属性名 | 类型 | 是否必填 | 描述 | 可选值 |
|---|---|---|---|---|
drive_id | string | 是 | drive_id表示盘id,参考drive.v7_list_drives接口返回的data.items[?].id | - |
file_id | string | 是 | file_id表示文件id,参考drive.v7_list_files接口返回的data.items[?].id,支持传0,表示盘的根目录 | - |
请求体(Body)
请求体格式: application/json
没有可用的数据
请求体示例
json
{
"notify_subject_user": true,
"overwrite": true,
"role_id": "string",
"subjects": [
{
"member_tag": "string",
"subject_id": "string",
"subject_type": "company"
}
]
}1
2
3
4
5
6
7
8
9
10
11
12
2
3
4
5
6
7
8
9
10
11
12
响应体(Response)
HTTP状态码: 200
响应体格式: application/json
没有可用的数据
响应体示例
json
{
"code": 0,
"msg": "string"
}1
2
3
4
2
3
4