获取文件操作权限

适用版本>=v7.0.2410as.20241017
接口说明：获取文件权限列表

请求说明

请求地址	配置域名+/openapi+`/v7/drives/{drive_id}/files/{file_id}/permissions/acl`
请求方法	GET
签名方式	KSO-1（配置域名+/openapi不参与签名）
权限要求	查询和管理文件权限（用户授权） `kso.file_permission.readwrite` 查询文件权限（用户授权） `kso.file_permission.read`

Header	参数类型	是否必填	说明
X-Kso-Date	string	是	RFC1123 格式的日期，例: `Wed, 23 Jan 2013 06:43:08 GMT`
X-Kso-Authorization	string	是	KSO-1 签名值，详见《签名方法》
Authorization	string	是	授权凭证，格式为：`Bearer {access_token}`

路径参数（Path）

名称	参数类型	是否必填	说明
drive_id	string	是	驱动盘id，<= 1024 characters
file_id	string	是	文件id，<= 1024 characters

查询参数（Query）

名称	参数类型	是否必填	说明
user_ids	string	是	用户id列表,以','分割，<= 1024 characters

响应体（Response）

名称	类型	说明
data	object
∟ items	object[]
∟ ∟ permission_bits	object	文件操作权限
∟ ∟ ∟ comment	boolean	评论
∟ ∟ ∟ copy	boolean	复制
∟ ∟ ∟ copy_content	boolean	内容复制
∟ ∟ ∟ delete	boolean	文件删除
∟ ∟ ∟ download	boolean	下载
∟ ∟ ∟ list	boolean	列表展示
∟ ∟ ∟ move	boolean	文件移动
∟ ∟ ∟ new_empty	boolean	新建
∟ ∟ ∟ perm_ctl	boolean	权限管理
∟ ∟ ∟ preview	boolean	预览
∟ ∟ ∟ print	boolean	打印
∟ ∟ ∟ rename	boolean	文件重命名
∟ ∟ ∟ share	boolean	分享
∟ ∟ ∟ update	boolean	编辑/更新
∟ ∟ ∟ upload	boolean	上传：手动上传新版本
∟ ∟ user_id	string	用户id
code	int	错误码
msg	string	状态信息
detail	string	详细信息

响应体示例

json

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