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

目录

  • 新建空间
  • 重命名空间
  • 解散空间
  • 获取空间信息
  • 新建空间

    该接口用于在微盘内新建空间,可以指定人创建空间。

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

    请求包体

    {
    	"userid": "USERID",
    	"space_name": "SPACE_NAME",
    	"auth_info": [{
    		"type": 1,
    		"userid": "USERID",
    		"auth": 2
    	}, {
    		"type": 2,
    		"departmentid": DEPARTMENTID,
    		"auth": 1
        }]
    }

    参数说明

    参数类型是否必须说明
    useridstring操作者userid
    space_namestring空间标题
    auth_infoobj[]空间其他成员信息
    typeuint32成员类型 1:个人 2:部门
    useridstring成员userid,字符串
    departmentiduint32部门departmentid, 32位整型范围是[0, 2^32)
    authuint32成员权限 1:可下载 2:可编辑 4:可预览(仅专业版企业可设置)

    返回示例

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

    参数说明

    参数类型说明
    errcodeint32错误码
    errmsgstring错误码说明
    spaceidstring空间id

    重命名空间

    该接口用于重命名已有空间,接收userid参数,以空间管理员身份来重命名。

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

    请求包体

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

    参数说明

    参数类型是否必须说明
    useridstring操作者userid
    spaceidstring空间spaceid
    space_namestring重命名后的空间名

    返回示例

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

    参数说明

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

    解散空间

    该接口用于解散已有空间,需要以空间管理员身份来解散。

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

    请求包体

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

    参数说明

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

    返回示例

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

    参数说明

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

    获取空间信息

    该接口用于获取空间成员列表、信息、权限等信息。

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

    请求包体

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

    参数说明

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

    返回示例

    {
    	"errcode": 0,
    	"errmsg": "ok",
    	"space_info": {
    		"spaceid": "SPACEID",
    		"space_name": "SPACE_NAME",
            "auth_list": {
    			"auth_info": [{
    				"type": 1,
    				"userid": "USERID1",
    				"auth": 3
    			}, {
    				"type": 1,
    				"userid": "USERID2",
    				"auth": 2
    			}, {
    				"type": 2,
    				"departmentid": DEPARTMENTID1,
    				"auth": 1
    			}],
                "quit_userid": ["USERID3","USERID4"]
            }
    	}
    }

    参数说明

    参数类型说明
    errcodeint32错误码
    errmsgstring错误码说明
    spaceidstring空间spaceid
    space_namestring空间名称
    auth_listobj[]空间成员列表
    auth_infoobj[]空间成员信息
    typeuint32成员类型 1:个人 2:部门
    useridstring成员userid,字符串
    departmentiduint32部门departmentid, 32位整型范围是[0, 2^32)
    authuint32成员权限 1:可下载 2:可编辑 3;管理员 4:可预览
    quit_useridstring[]空间无权限成员userid (成员在一个有权限的部门中, 自己退出空间或者被移除权限)
    上一篇
    概述
    下一篇
    空间权限