增加协作者权限

POST

https://open.feishu.cn/open-apis/drive/v1/permissions/{token}/members

该接口用于根据 filetoken 给用户增加文档的权限。
目前使用tenant_access_token访问还不支持以下参数：

type参数：不支持folder类型

need_notification参数：默认不通知

错误码

HTTP状态码	错误码	描述	排查建议
400	1063001	Invalid parameter	参数异常，可能是如下原因：参数类型不匹配，如：文档的token和type不匹配。参数填写异常，如：token或type填写不符合文档要求。
403	1063002	Permission denied	无权限操作，可能是如下原因：调用身份无权限，如：调用身份对应的用户不在云文档的协作者中，无权限操作。
400	1063003	Invalid operation	非法操作，可能是如下原因：协作者数量到达上限。修改云文档权限设置但因企业的管控而无法修改。可见性限制，如：邀请自不在群内的群协作者、邀请自己不在部门内的部门协作者。
403	1063004	User has no share permission	用户无分享权限，请确认调用身份对该文档是否有分享权限。
404	1063005	Resource is deleted	资源已删除，请确认云文档是否还存在。
500	1066001	Internal Error	服务内部错误，包括服务端内部超时、错误码没处理等。
500	1066002	Concurrency error, please retry	服务内部错误，请重试。

请求示例

Shell

JavaScript

Java

Swift

curl --location --request POST 'https://open.feishu.cn/open-apis/drive/v1/permissions/doccnBKgoMyY5OMbUG6FioTXuBe/members?type' \
--header 'Authorization;' \
--header 'Content-Type: application/json' \
--data-raw '{
    "member_type": "openid",
    "member_id": "ou_67e5ecb64ce1c0bd94612c17999db411",
    "perm": "view"
}'

响应示例

{
  "code": 0,
  "msg": "success",
  "data": {
    "member": {
      "member_type": "openid",
      "member_id": "ou_67e5ecb64ce1c0bd94612c17999db411",
      "perm": "view"
    }
  }
}

请求参数

Path 参数

token

string

必需

文件的 token，获取方式见如何获取云文档资源相关 token

示例值:

doccnBKgoMyY5OMbUG6FioTXuBe

Query 参数

type

string

必需

文件类型，需要与文件的 token 相匹配示例值："doc" 可选值有： doc：文档 sheet：电子表格 file：云空间文件 wiki：知识库节点 bitable：多维表格 docx：新版文档 folder：文件夹 mindnote：思维笔记 minutes：妙记

need_notification

string

可选

添加权限后是否通知对方注意：使用tenant_access_token访问不支持该参数示例值：false 默认值：false

Header 参数

Authorization

string

必需

tenant_access_token 或 user_access_token 值格式："Bearer access_token" 示例值："Bearer u-7f1bcd13fc57d46bac21793a18e560"

默认值:

Bearer {{access_token}}

Content-Type

string

必需

固定值："application/json; charset=utf-8"

默认值:

application/json; charset=utf-8

Body 参数application/json

member_type

string

必需

协作者 ID 类型，与协作者 ID 需要对应示例值："openid" 可选值有： email：飞书邮箱 openid：开放平台ID openchat：开放平台群组ID opendepartmentid：开放平台部门ID userid：用户自定义ID

member_id

string

必需

协作者 ID，与协作者 ID 类型需要对应示例值："ou_67e5ecb64ce1c0bd94612c17999db411"

perm

string

必需

协作者对应的权限角色注意：妙记还不支持可管理角色示例值："view" 可选值有： view：可阅读角色 edit：可编辑角色 full_access：可管理角色

示例

返回响应

🟢200成功

application/json

Body

code

integer

必需

错误码，非 0 表示失败

msg

string

错误描述

必需

data

object

必需

member

object

必需

本次添加权限的用户信息

修改于 2023-01-13 06:57:13

获取协作者列表

更新协作者权限

增加协作者权限

错误码#

请求参数

返回响应

错误码