跳到主要内容
版本:latest

UploadFile

上传文件到指定目录。与面板其他接口不同,本接口使用 multipart/form-data 格式。

  • 路由POST /files
  • actionUploadFile
  • Content-Typemultipart/form-data(非 form-urlencoded)

输入参数

参数名称必选类型描述
actionStringUploadFile(FormData 字段)
pathString目标目录路径
zunfileFile上传的文件(FormData 文件字段)
request_timeString认证时间戳(FormData 字段)
request_tokenString认证令牌(FormData 字段)

注意:认证参数 request_timerequest_token 也要以 FormData 字段方式传递,不能放在 URL query 中。

输出参数

参数名称类型描述
statusBooleantrue 上传成功
msgString上传成功!

示例

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": "上传成功!"}