移动文档

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

# 移动文档

# 接口说明

本接口用于将一个文档移动到指定文件夹。需要预先准备目标文件夹的 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
1
2
3
4
5
6
7
8
9
1
2
3
4
5
6
7
8
9

# 示例

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'\
1
2
3
4
5
6
7
1
2
3
4
5
6
7

# 响应包体

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'}
1
2
3
4
5
6
7
1
2
3
4
5
6
7

# 错误码

错误码 错误说明 排查建议
10202 文件或文件夹不存在 - 检查 fileID 参数是否正确,fileID 的获取方式见fileID

- 检查 targetFolderID 参数是否正确,folderID 的获取方式见folderID

- parentFolderID 参数可以使用 \

查询更多业务返回码

上次编辑于: 2023年5月31日 11:27
贡献者: mylochen , muyanyang , livlin