Skip to content

获取用户的文件操作权限

标签文件权限

请求说明

字段
请求地址
https://openapi.wps.cn/v7/drives/{drive_id}/files/{file_id}/permissions/acl
HTTP 方法
GET
接口描述
一个或多个用户对文件可以进行哪些操作,比如我可以对文件进行复制/移动/删除等。通常在文件右键菜单展示文件允许的操作入口。
签名方式
KSO-1
限频策略
权限要求
查询和管理文件权限(用户授权) kso.file_permission.readwrite
查询文件权限(用户授权) kso.file_permission.read

请求头 (Headers)

属性名类型是否必填描述可选值
X-Kso-Id-Type
string类型
* internal - 内部
* external - 外部
internal, external

路径参数 (Path)

属性名类型是否必填描述可选值
drive_id
stringdrive_id表示盘id,参考drive.v7_list_drives接口返回的data.items[?].id-
file_id
stringfile_id表示文件id,参考drive.v7_list_files接口返回的data.items[?].id,支持传0,表示盘的根目录-

查询参数 (Query)

属性名类型是否必填描述可选值
user_ids
string用户id列表,以','分割-

响应体(Response)

HTTP状态码: 200
响应体格式: application/json

没有可用的数据

响应体示例

json
{
  "data": {
    "items": [
      {
        "permission_bits": {
          "comment": true,
          "copy": true,
          "copy_content": true,
          "delete": true,
          "download": true,
          "history": true,
          "list": true,
          "move": true,
          "new_empty": true,
          "perm_ctl": true,
          "preview": true,
          "print": true,
          "rename": true,
          "saveas": true,
          "secret": true,
          "share": true,
          "update": true,
          "upload": true
        },
        "user_id": "string"
      }
    ]
  },
  "code": 0,
  "msg": "string"
}