获取协作者列表（新版本）

GET

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

该接口用于根据 filetoken 查询协作者
你能获取到协作者列表的前提是你对该文档有分享权限
目前仅支持人、群、组织架构三种类型的协作者

错误码

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	资源已删除，请确认云文档是否还存在。
429	1063006	Too many request	请求发生限频，请降低请求频率并稍后重试。
500	1066001	Internal Error	服务内部错误，包括服务端内部超时、错误码没处理等。
500	1066002	Concurrency error, please retry	服务内部错误，请重试。

请求示例

Shell

JavaScript

Java

Swift

curl --location --request GET 'https://open.feishu.cn/open-apis/drive/v1/permissions/doccnBKgoMyY5OMbUG6FioTXuBe/members?type' \
--header 'Authorization;'

响应示例

{
  "code": 0,
  "msg": "success",
  "data": {
    "items": [
      {
        "member_type": "openid",
        "member_id": "ou_7dab8a3d3cdcc9da365777c7ad535d62",
        "perm": "view",
        "type": "user",
        "name": "zhangsan",
        "avatar": "https://foo.icon.com/xxxx",
        "external_label": true
      }
    ]
  }
}

请求参数

Path 参数

token

string

必需

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

示例值:

doccnBKgoMyY5OMbUG6FioTXuBe

Query 参数

type

string

必需

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

fields

string

可选

指定返回的协作者字段信息，如无指定则默认不返回可选值有： name：协作者名 type：协作者类型 avatar：头像 external_label：外部标签注意：你可以使用特殊值指定返回目前支持的所有字段你可以使用,分隔若干个你想指定返回的字段，如：name,avatar 按需指定返回字段接口性能更好示例值：""

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

返回响应

🟢200成功

application/json

Body

code

integer

必需

错误码，非 0 表示失败

msg

string

错误描述

必需

data

object

必需

items

array [object {7}]

返回的列表数据

必需

修改于 2023-01-13 06:54:20

判断当前用户是否有某权限

获取协作者列表

获取协作者列表（新版本）

错误码#

请求参数

返回响应

错误码