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

开发中

GET

/api/v1/control/file/transfer/state

只能查询到正在进行中的，如果已经取消则不会返回结果

请求参数

Authorization

在 header 添加参数

X-AweSun-Api-Token

示例：

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

Query 参数

Header 参数

请求示例代码

Shell

JavaScript

Java

Swift

PHP

Python

HTTP

Objective-C

Ruby

OCaml

Dart

curl --location --request GET '/api/v1/control/file/transfer/state?session_id=session_id=r=1425623155;p=file;&transfer_id=123' \
--header 'X-Ca-Api-Token;' \
--header 'X-AweSun-Api-Token: <api-key>'

返回响应

🟢200成功

application/json

Body

示例

{
    "code": 0,
    "message": "success",
    "data": {
        "total": 1,
        "transfers": [
            {
                "session_id": "",
                "transfer_id": "xxx",
                "transfer_type": "down",
                "transfer_status": "transferring",
                "local_path": "",
                "remote_path": "",
                "total_bytes": 1000,
                "speed_bytes": 289,
                "transferred_bytes": 100,
                "remaining_seconds": 300,
                "progress_percent": 10
            }
        ]
    }
}

修改于 2026-03-25 05:56:34

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

取消正在进行中的文件传输任务