产品概述
功能介绍
产品优势
应用场景
基本概念
POST /api/v1/batch/{LibraryId}/{SpaceId}?copy&access_token={AccessToken}&user_id={UserId}
[{"copyFromSpaceId":"spaceNJsnjdiq","copyFrom": "bar","to": "foo/bar"},{"copyFrom": "foo/1.jpg","to": "bar/1.jpg"},{"copyFrom": "foo/2.jpg","to": "bar/2.jpg","conflictResolutionStrategy": "overwrite"}]
请求参数 | 描述 | 类型 | 是否必选 |
copyFrom | 被复制的源目录、相簿或文件路径 | String | 是 |
to | 目标目录、相簿或文件路径 | String | 是 |
conflictResolutionStrategy | 文件名冲突时的处理方式 ask：冲突时返回 status：409 及 SameNameDirectoryOrFileExists 错误码 rename：冲突时自动重命名文件 overwrite： 如果目标为目录或相簿时，默认为 ask 且不支持 overwrite 如果目标为文件，覆盖已有文件 当目标空间的文件存在历史版本时，不支持移动覆盖 | String | 否 |
copyFromSpaceId | 跨空间复制时指定源目录或文件所在的空间，同空间复制时请勿指定该字段 | String | 否 |
- 当项目较多以异步方式复制时，返回 HTTP 202 Accepted。 - 当项目较少以同步方式复制时，返回 HTTP 200 OK（全部执行成功）或 HTTP 207 Multi-Status（存在部分或全部执行失败）。
{"result": [{"status": 204,"copyFrom": "bar","to": [ "foo", "bar" ]},{"status": 200,"path": [ "bar", "1 (1).jpg" ],"copyFrom": [ "foo", "1.jpg" ],"to": [ "bar", "1.jpg" ]},{"status": 204,"copyFrom": [ "foo", "2.jpg" ],"to": [ "bar", "2.jpg" ]}]}
{ "taskId": 16 }
[{"taskId": 16,"status": 200,"result": [{"status": 204,"copyFrom": "bar","to": [ "foo", "bar" ]},{"status": 200,"path": [ "bar", "1 (1).jpg" ],"copyFrom": [ "foo", "1.jpg" ],"to": [ "bar", "1.jpg" ]},{"status": 204,"copyFrom": [ "foo", "2.jpg" ],"to": [ "bar", "2.jpg" ]}]}]
响应参数 | 描述 | 类型 |
result.status | 单个项目的复制结果： 200: conflictResolutionStrategy 为 rename 时复制成功 204: conflictResolutionStrategy 为 ask 或 overwrite 时复制成功 403/404/409/500等，复制失败 | String |
result.path | 表示最终的路径，因为可能存在自动重命名，所以这里的最终路径可能不等同于复制时指定的路径 | String Array |
result.copyFrom | 发起请求时传入的对应路径 | String Array |
result.to | 发起请求时传入的对应路径 | String Array |
响应参数 | 描述 | 类型 |
status | 查询任务状态： 202：任务进行中 200：全部执行成功 207：存在部分或全部执行失败 | String |
文档反馈