登录
企业内部开发 服务端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
}]
}参数说明
| 参数 | 类型 | 是否必须 | 说明 |
|---|---|---|---|
| userid | string | 是 | 操作者userid |
| spaceid | string | 是 | 空间spaceid |
| auth_info | obj[] | 是 | 被添加的空间成员信息 |
| type | uint32 | 是 | 成员类型 1:个人 2:部门 |
| userid | string | 是 | 成员userid,字符串 (type为1时填写) |
| departmentid | uint32 | 是 | 部门departmentid, 32位整型范围是[0, 2^32) (type为2时填写) |
| auth | uint32 | 是 | 1:可下载 2:可编辑 4:可预览（仅专业版企业可设置） |
返回示例
{
"errcode": 0,
"errmsg": "ok"
}参数说明
| 参数 | 类型 | 说明 |
|---|---|---|
| errcode | int32 | 错误码 |
| errmsg | string | 错误码说明 |
移除成员/部门
该接口用于对指定空间移除成员/部门，操作者需要有移除权限。
请求方式：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
}]
}参数说明
| 参数 | 类型 | 是否必须 | 说明 |
|---|---|---|---|
| userid | string | 是 | 操作者userid |
| spaceid | string | 是 | 空间spaceid |
| auth_info | obj[] | 是 | 被移除的空间成员信息 |
| type | uint32 | 是 | 成员类型 1:个人 2:部门 |
| userid | string | 是 | 成员userid,字符串 (type为1时填写) |
| departmentid | uint32 | 是 | 部门departmentid, 32位整型范围是[0, 2^32) (type为2时填写) |
返回示例
{
"errcode": 0,
"errmsg": "ok"
}参数说明
| 参数 | 类型 | 说明 |
|---|---|---|
| errcode | int32 | 错误码 |
| errmsg | string | 错误码说明 |
权限管理
该接口用于修改空间权限，需要传入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
}参数说明
| 参数 | 类型 | 是否必须 | 说明 |
|---|---|---|---|
| userid | string | 是 | 操作者userid |
| spaceid | string | 是 | 空间spaceid |
| enable_watermark | bool | 否 | （本字段仅专业版企业可设置）启用水印。false:关 true:开 ;如果不填充此字段为保持原有状态 |
| add_member_only_admin | bool | 否 | 仅管理员可增减空间成员和修改文件分享设置。false:关 true:开 ；如果不填充此字段为保持原有状态 |
| enable_share_url | bool | 否 | 启用成员邀请链接。false:关 true:开 ；如果不填充此字段为保持原有状态 |
| share_url_no_approve | bool | 否 | 通过链接加入空间无需审批。false:关； true:开； 如果不填充此字段为保持原有状态 |
| share_url_no_approve_default_auth | uint32 | 否 | 邀请链接默认权限。1:仅浏览（可下载）2:可编辑 4:可预览（仅专业版企业可设置）；如果不填充此字段为保持原有状态 |
返回示例
{
"errcode": 0,
"errmsg": "ok"
}参数说明
| 参数 | 类型 | 说明 |
|---|---|---|
| errcode | int32 | 错误码 |
| errmsg | string | 错误码说明 |
获取邀请链接
该接口用于获取空间邀请分享链接。
请求方式：POST（HTTPS）
请求地址: https://qyapi.weixin.qq.com/cgi-bin/wedrive/space_share?access_token=ACCESS_TOKEN
请求包体
{
"userid": "USERID",
"spaceid": "SPACEID"
}参数说明
| 参数 | 类型 | 是否必须 | 说明 |
|---|---|---|---|
| userid | string | 是 | 操作者userid |
| spaceid | string | 是 | 空间spaceid |
返回示例
{
"errcode": 0,
"errmsg": "ok",
"space_share_url": "SPACE_SHARE_URL"
}参数说明
| 参数 | 类型 | 说明 |
|---|---|---|
| errcode | int32 | 错误码 |
| errmsg | string | 错误码说明 |
| space_share_url | string | 邀请链接 |
