企业内部开发 服务端API 效率工具 微盘 文件权限
文件权限

目录

  • 新增指定人
  • 删除指定人
  • 分享设置
  • 获取分享链接
  • 新增指定人

    该接口用于对指定文件添加指定人/部门。

    请求方式:POST(HTTPS
    请求地址: https://qyapi.weixin.qq.com/cgi-bin/wedrive/file_acl_add?access_token=ACCESS_TOKEN

    请求包体

    {
    	"userid": "USERID",
    	"fileid": "FILEID",
    	"auth_info": [{
    		"type": 1,
    		"userid": "USERID1",
            "auth": 1
    	}, {
    		"type": 2,
    		"departmentid": DEPARTMENT_ID1,
            "auth": 1	
    	}]
    }

    参数说明

    参数类型是否必须说明
    useridstring操作者userid
    fileidstring文件fileid
    auth_infoobj[]添加成员的信息
    typeuint32成员类型 1:个人 2:部门
    useridstring成员userid,字符串 (type为1时填写)
    authuint32新增成员的权限信息
    普通文档:1:仅浏览(可下载) 4:仅预览(仅专业版企业可设置);如果不填充此字段为保持原有状态
    微 文 档:1:仅浏览(可下载)2:可编辑;如果不填充此字段为保持原有状态
    departmentiduint32部门departmentid, 32位整型范围是[0, 2^32) (type为2时填写)

     

    返回示例

    {
    	"errcode": 0,
    	"errmsg": "ok"
    }

    参数说明

    参数类型说明
    errcodeint32错误码
    errmsgstring错误码说明

    删除指定人

    该接口用于删除指定文件的指定人/部门。

    请求方式:POST(HTTPS
    请求地址: https://qyapi.weixin.qq.com/cgi-bin/wedrive/file_acl_del?access_token=ACCESS_TOKEN

    请求包体

    {
    	"userid": "USERID",
    	"fileid": "FILEID",
    	"auth_info": [{
    		"type": 1,
    		"userid": "USERID1"
    	}, {
    		"type": 2,
    		"departmentid": DEPARTMENT_ID1	
    	}]
    }

    参数说明

    参数类型是否必须说明
    useridstring操作者userid
    fileidstring文件fileid
    auth_infoobj[]被移除的成员信息
    typeuint32成员类型 1:个人 2:部门
    useridstring成员userid,字符串 (type为1时填写)
    departmentiduint32部门departmentid, 32位整型范围是[0, 2^32) (type为2时填写)

     

    返回示例

    {
    	"errcode": 0,
    	"errmsg": "ok"
    }

    参数说明

    参数类型说明
    errcodeint32错误码
    errmsgstring错误码说明

    分享设置

    该接口用于文件的分享设置。

    请求方式:POST(HTTPS
    请求地址: https://qyapi.weixin.qq.com/cgi-bin/wedrive/file_setting?access_token=ACCESS_TOKEN

    请求包体

    {
    	"userid": "USERID",
    	"fileid": "FILDID",
    	"auth_scope": AUTH_SCOPE,
    	"auth": 1
    }

    参数说明

    参数类型是否必须说明
    useridstring操作者userid
    fileidstring文件fileid
    auth_scopeuint32权限范围:1:指定人 2:企业内 3:企业外
    authuint32权限信息
    普通文档: 1:仅浏览(可下载) 4:仅预览(仅专业版企业可设置);如果不填充此字段为保持原有状态
    微文档: 1:仅浏览(可下载) 2:可编辑;如果不填充此字段为保持原有状态

     

    返回示例

    {
    	"errcode": 0,
    	"errmsg": "ok"
    }

    参数说明

    参数类型说明
    errcodeint32错误码
    errmsgstring错误码说明

    获取分享链接

    该接口用于获取文件的分享链接。

    请求方式:POST(HTTPS
    请求地址: https://qyapi.weixin.qq.com/cgi-bin/wedrive/file_share?access_token=ACCESS_TOKEN

    请求包体

    {
    	"userid": "USERID",
    	"fileid": "FILEID"
    }

    参数说明

    参数类型是否必须说明
    useridstring操作者userid
    fileidstring文件fileid

    返回示例

    {
    	"errcode": 0,
    	"errmsg": "ok",
    	"share_url": "SHARE_URL"
    }

    参数说明

    参数类型说明
    errcodeint32错误码
    errmsgstring错误码说明
    share_urlstring分享文件的链接
    上一篇
    文件管理
    下一篇
    获取公费电话拨打记录