创建传输文件或文件夹（双向）任务

开发中

POST

/api/v1/control/file/transfer

成功建立连接后则立即返回，通过/api/v1/control/file/transfer/state查询传输进度或通过/api/v1/control/file/transfer/cancel取消

请求参数

Authorization

在 header 添加参数

X-AweSun-Api-Token

示例：

X-AweSun-Api-Token: ********************

Header 参数

Body 参数application/json必填

示例

{
  "session_id": "session_id=r=1425623155;p=file;",
  "transfer_type": "down",
  "local_path": "/Users/wuwenze/Downloads/Upload.txt",
  "remote_path": "C:\\Users\\helloworld\\Downloads\\test\\Upload.txt",
  "override": true
}

请求示例代码

Shell

JavaScript

Java

Swift

PHP

Python

HTTP

Objective-C

Ruby

OCaml

Dart

curl --location --request POST '/api/v1/control/file/transfer' \
--header 'X-Ca-Api-Token;' \
--header 'X-AweSun-Api-Token: <api-key>' \
--header 'Content-Type: application/json' \
--data-raw '{
  "session_id": "session_id=r=1425623155;p=file;",
  "transfer_type": "down",
  "local_path": "/Users/wuwenze/Downloads/Upload.txt",
  "remote_path": "C:\\Users\\helloworld\\Downloads\\test\\Upload.txt",
  "override": true
}'

返回响应

🟢200成功

application/json

Body

示例

{
  "code": 0,
  "message": "success",
  "data": {
    "transfer_id": "xxxxxxxxx"
  }
}

修改于 2026-03-25 05:53:04

在远程主机重命名文件或文件夹

查询进行中文件/文件夹传输任务进度