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

目录

  • 添加成员/部门
  • 移除成员/部门
  • 权限管理
  • 获取邀请链接
  • 添加成员/部门

    该接口用于对指定空间添加成员/部门,可一次性添加多个。

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

    请求包体

    {
    	"userid": "USERID",
    	"spaceid": "SPACEID",
    	"auth_info": [{
    		"type": 1,
    		"userid": "USERID1",
    		"auth": 2
    	}, {
    		"type": 2,
    		"departmentid": DEPARTMENTID1,
    		"auth": 2
    	}]
    }

    参数说明

    参数类型是否必须说明
    useridstring操作者userid
    spaceidstring空间spaceid
    auth_infoobj[]被添加的空间成员信息
    typeuint32成员类型 1:个人 2:部门
    useridstring成员userid,字符串 (type为1时填写)
    departmentiduint32部门departmentid, 32位整型范围是[0, 2^32) (type为2时填写)
    authuint321:可下载 2:可编辑 4:可预览(仅专业版企业可设置)

    返回示例

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

    参数说明

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

     

    移除成员/部门

    该接口用于对指定空间移除成员/部门,操作者需要有移除权限。

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

    请求包体

    {
    	"userid": "USERID",
    	"spaceid": "SPACEID",
    	"auth_info": [{
    		"type": 1,
    		"userid": "USERID1"
    	}, {
    		"type": 2,
    		"departmentid": DEPARTMENTID1
    	}]
    }

    参数说明

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

     

    返回示例

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

    参数说明

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

    权限管理

    该接口用于修改空间权限,需要传入userid,修改权限范围继承传入用户的权限范围。

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

    请求包体

    {
        "userid": "USERID",
        "spaceid": "SPACEID",
        "enable_watermark": true,
        "add_member_only_admin": true,
        "enable_share_url": false,
        "share_url_no_approve": true,
        "share_url_no_approve_default_auth": 4
    }

    参数说明

    参数类型是否必须说明
    useridstring操作者userid
    spaceidstring空间spaceid
    enable_watermarkbool(本字段仅专业版企业可设置)启用水印。false:关 true:开 ;如果不填充此字段为保持原有状态
    add_member_only_adminbool仅管理员可增减空间成员和修改文件分享设置。false:关 true:开 ;如果不填充此字段为保持原有状态
    enable_share_urlbool启用成员邀请链接。false:关 true:开 ;如果不填充此字段为保持原有状态
    share_url_no_approvebool通过链接加入空间无需审批。false:关; true:开; 如果不填充此字段为保持原有状态
    share_url_no_approve_default_authuint32邀请链接默认权限。1:仅浏览(可下载)2:可编辑 4:可预览(仅专业版企业可设置);如果不填充此字段为保持原有状态

    返回示例

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

    参数说明

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

    获取邀请链接

    该接口用于获取空间邀请分享链接。

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

    请求包体

    {
    	"userid": "USERID",
    	"spaceid": "SPACEID"
    }

    参数说明

    参数类型是否必须说明
    useridstring操作者userid
    spaceidstring空间spaceid

    返回示例

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

    参数说明

    参数类型说明
    errcodeint32错误码
    errmsgstring错误码说明
    space_share_urlstring邀请链接
    上一篇
    空间管理
    下一篇
    文件管理