Question

openID 300

接口说明

本接口用于将一个文档移动到指定文件夹。需要预先准备目标文件夹的 folderID（获取方式见folderID）。

权限说明

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

• scope.drive.editable
• scope.drive.file.metadata

请求格式

描述	定义
Path	/openapi/drive/v2/files/{fileID}/move
Method	PATCH
Content-Type	application/x-www-form-urlencoded
Accept	application/json

请求头部

详见Headers。

请求参数

路径参数

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

查询参数

无

请求体

参数名	类型	必选	描述
targetfolderID	string	是	移动的目标文件夹唯一标识，默认为 /
parentfolderID	string	是	上级文件夹唯一标识，默认为 /

响应参数

请求体

参数名	类型	描述
ret	integer	业务返回码
msg	string	业务返回码描述

请求包体

PATCH /openapi/drive/v2/files/300000000$AAAAAAAAAAAA/move HTTP/1.1
Host: docs.qq.com
Access-Token: ACCESS_TOKEN
Client-Id: CLIENT_ID
Open-Id: OPEN_ID
Content-Type: application/x-www-form-urlencoded
Content-Length: 56

targetFolderID=FOLDER_ID&parentFolderID=PARENT_FOLDER_ID

示例

curl --location --request PATCH 'https://docs.qq.com/openapi/drive/v2/files/300000000$AAAAAAAAAAAA/move' \
--header 'Access-Token: ACCESS_TOKEN' \
--header 'Client-Id: CLIENT_ID' \
--header 'Open-Id: OPEN_ID' \
--header 'Content-Type: application/x-www-form-urlencoded' \
--data-urlencode 'targetFolderID=FOLDER_ID' \
--data-urlencode 'parentFolderID=PARENT_FOLDER_ID'\

响应包体

HTTP/1.1 200 OK
Date: Thu, 28 Jul 2022 15:34:46 GMT
Content-Type: text/plain; charset=utf-8
Content-Length: 2
Connection: keep-alive
 
{'ret': 0, 'msg': 'Succeed'}

错误码

错误码	错误说明	排查建议
10202	文件或文件夹不存在	- 检查 fileID 参数是否正确，fileID 的获取方式见fileID； - 检查 targetFolderID 参数是否正确，folderID 的获取方式见folderID ； - parentFolderID 参数可以使用 \

查询更多业务返回码