获取云文档权限设置

GET

/drive/v1/permissions/{token}/public

该接口用于根据 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	资源已删除，请确认云文档是否还存在。
500	1066001	Internal Error	服务内部错误，包括服务端内部超时、错误码没处理等。

请求参数

Authorization

Bearer Token

在 Header 添加参数

Authorization

，其值为在 Bearer 之后拼接 Token

示例：

Authorization: Bearer ********************

Path 参数

Query 参数

返回响应

🟢200成功

application/json

Body

请求示例

Shell

JavaScript

Java

Swift

curl --location --request GET 'https://open.feishu.cn/open-apis/drive/v1/permissions/doccnBKgoMyY5OMbUG6FioTXuBe/public?type' \
--header 'Authorization: Bearer <token>'

响应示例

{
    "code": 0,
    "msg": "success",
    "data": {
        "permission_public": {
            "external_access": true,
            "security_entity": "anyone_can_view",
            "comment_entity": "anyone_can_view",
            "share_entity": "anyone",
            "link_share_entity": "tenant_readable",
            "invite_external": true,
            "lock_switch": false
        }
    }
}

修改于 2025-10-21 04:06:08

移除协作者权限

更新云文档权限设置

获取云文档权限设置

错误码#

请求参数

返回响应

错误码