查询用户访问权限

... 2022-7-14 大约 2 分钟

# 查询用户访问权限

# 接口说明

本接口用于获取用户对文档的访问权限。

# 请求格式

描述	定义
Path	/openapi/drive/v2/files/{fileID}/access
Method	GET
Accept	application/json

Scope

本接口需要拥有以下任意一项权限：

scope.drive.file.permission
scope.drive.file.permission.readonly

# 请求头部

详见Headers。

# 请求参数

# 路径参数

参数名	类型	必选	描述
fileID	string	是	文档唯一标识，详见fileID

# 查询参数

无

# 请求体

无

# 响应参数

# 请求体

参数名	类型	描述
ret	integer	业务返回码
msg	string	业务返回码描述
data.isOwner	boolean	是否文档所有者
data.readEnable	boolean	是否允许查看
data.editEnable	boolean	是否允许编辑
data.downloadEnable	boolean	是否禁止查看者复制、保存为本地文件、打印内容
data.cloneEnable	boolean	是否可以创建副本
data.watermarkEnable	boolean	是否允许设置水印

# 请求包体

GET /openapi/drive/v2/files/300000000$AAAAAAAAAAAA/access HTTP/1.1
Host: docs.qq.com
Access-Token: ACCESS_TOKEN
Client-Id: CLIENT_ID
Open-Id: OPEN_ID
Content-Length: 0

1
2
3
4
5
6

# 示例

curl --location --request GET 'https://docs.qq.com/openapi/drive/v2/files/300000000$AAAAAAAAAAAA/access' \
--header 'Access-Token: ACCESS_TOKEN' \
--header 'Client-Id: CLIENT_ID' \
--header 'Open-Id: OPEN_ID'

1
2
3
4

# 响应包体

HTTP/1.1 200 OK
Date: Thu, 28 Jul 2022 15:34:46 GMT
Content-Type: text/plain; charset=utf-8
Content-Length: 3
Connection: keep-alive
 
{'ret': 0, 'msg': 'Succeed', 'data': {'isOwner': False, 'readEnable': True, 'editEnable': False, 'downloadEnable': False, 'cloneEnable': False, 'watermarkEnable': False}}

1
2
3
4
5
6
7

# 错误码

错误码	错误说明	排查建议
10313	Access-Token 为空	HTTP Header 里 `Access-Token` 校验失败，请参考示例中的携带方式，检查相应字段。详情请见Headers。
10303	Open-Id 错误	HTTP Header 里 `Open-Id` 与预期不符，可能的原因有： - `Open-Id`为空。请参考示例中的携带方式，检查相应字段。详情请见Headers。 - `Open-Id`与`Access-Token`不匹配，请检查Header内容和获取Token接口回包是否一致。
10302	Client-Id 错误	HTTP Header 里 `Client-Id` 与预期不符，可能的原因有： - `Client-Id`为空。请参考示例中的携带方式，检查相应字段。详情请见Headers。 - `Client-Id`与`Access-Token`不匹配，请检查Header内容和调用获取Token接口接口时参数中的`Client-Id`是否一致。
37019	Token校验失败，错误或过期	检查位于HTTP Header 中的 `Access-Token` 是否正确，获取Token的方式请查阅授权流程以及获取Token接口

查询更多业务返回码

重命名文件夹查看文档权限