登录
企业内部开发 服务端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
}]
}参数说明
| 参数 | 类型 | 是否必须 | 说明 |
|---|---|---|---|
| userid | string | 是 | 操作者userid |
| space_name | string | 是 | 空间标题 |
| auth_info | obj[] | 否 | 空间其他成员信息 |
| type | uint32 | 否 | 成员类型 1:个人 2:部门 |
| userid | string | 否 | 成员userid,字符串 |
| departmentid | uint32 | 否 | 部门departmentid, 32位整型范围是[0, 2^32) |
| auth | uint32 | 否 | 成员权限 1:可下载 2:可编辑 4:可预览（仅专业版企业可设置） |
返回示例
{
"errcode": 0,
"errmsg": "ok",
"spaceid": "SPACEID"
}参数说明
| 参数 | 类型 | 说明 |
|---|---|---|
| errcode | int32 | 错误码 |
| errmsg | string | 错误码说明 |
| spaceid | string | 空间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"
}参数说明
| 参数 | 类型 | 是否必须 | 说明 |
|---|---|---|---|
| userid | string | 是 | 操作者userid |
| spaceid | string | 是 | 空间spaceid |
| space_name | string | 是 | 重命名后的空间名 |
返回示例
{
"errcode": 0,
"errmsg": "ok"
}参数说明
| 参数 | 类型 | 说明 |
|---|---|---|
| errcode | int32 | 错误码 |
| errmsg | string | 错误码说明 |
解散空间
该接口用于解散已有空间，需要以空间管理员身份来解散。
请求方式：POST（HTTPS）
请求地址: https://qyapi.weixin.qq.com/cgi-bin/wedrive/space_dismiss?access_token=ACCESS_TOKEN
请求包体
{
"userid": "USERID",
"spaceid": "SPACEID"
}参数说明
| 参数 | 类型 | 是否必须 | 说明 |
|---|---|---|---|
| userid | string | 是 | 操作者userid |
| spaceid | string | 是 | 空间spaceid |
返回示例
{
"errcode": 0,
"errmsg": "ok"
}参数说明
| 参数 | 类型 | 说明 |
|---|---|---|
| errcode | int32 | 错误码 |
| errmsg | string | 错误码说明 |
获取空间信息
该接口用于获取空间成员列表、信息、权限等信息。
请求方式：POST（HTTPS）
请求地址: https://qyapi.weixin.qq.com/cgi-bin/wedrive/space_info?access_token=ACCESS_TOKEN
请求包体
{
"userid": "USERID",
"spaceid": "SPACEID"
}参数说明
| 参数 | 类型 | 是否必须 | 说明 |
|---|---|---|---|
| userid | string | 是 | 操作者userid |
| spaceid | string | 是 | 空间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"]
}
}
}参数说明
| 参数 | 类型 | 说明 |
|---|---|---|
| errcode | int32 | 错误码 |
| errmsg | string | 错误码说明 |
| spaceid | string | 空间spaceid |
| space_name | string | 空间名称 |
| auth_list | obj[] | 空间成员列表 |
| auth_info | obj[] | 空间成员信息 |
| type | uint32 | 成员类型 1:个人 2:部门 |
| userid | string | 成员userid,字符串 |
| departmentid | uint32 | 部门departmentid, 32位整型范围是[0, 2^32) |
| auth | uint32 | 成员权限 1:可下载 2:可编辑 3;管理员 4:可预览 |
| quit_userid | string[] | 空间无权限成员userid (成员在一个有权限的部门中, 自己退出空间或者被移除权限) |
