Question

openID 300

接口说明

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

请求格式

描述	定义
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

示例

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'

响应包体

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}}

错误码

错误码	错误说明	排查建议
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接口

查询更多业务返回码