UploadFile
上传文件到指定目录。与面板其他接口不同,本接口使用 multipart/form-data 格式。
- 路由:
POST /files - action:
UploadFile - Content-Type:
multipart/form-data(非 form-urlencoded)
输入参数
| 参数名称 | 必选 | 类型 | 描述 |
|---|---|---|---|
| action | 是 | String | UploadFile(FormData 字段) |
| path | 是 | String | 目标目录路径 |
| zunfile | 是 | File | 上传的文件(FormData 文件字段) |
| request_time | 是 | String | 认证时间戳(FormData 字段) |
| request_token | 是 | String | 认证令牌(FormData 字段) |
注意:认证参数
request_time和request_token也要以 FormData 字段方式传递,不能放在 URL query 中。
输出参数
| 参数名称 | 类型 | 描述 |
|---|---|---|
| status | Boolean | true 上传成功 |
| msg | String | 上传成功! |
示例
Python
import requests
url = 'http://192.168.168.213:8888/files'
data = {
'action': 'UploadFile',
'path': '/www/wwwroot/testapi.bt.local',
'request_time': str(int(time.time())),
'request_token': token,
}
files = {'zunfile': ('test.txt', 'Hello World', 'text/plain')}
r = requests.post(url, data=data, files=files)
cURL
curl -F 'action=UploadFile' \
-F 'path=/www/wwwroot/testapi.bt.local' \
-F 'request_time=1700000000' \
-F 'request_token=xxx' \
-F 'zunfile=@local_file.txt' \
http://192.168.168.213:8888/files
响应
{"status": true, "msg": "上传成功!"}