上传文件 - Jdevelops

请求参数

Body 参数multipart/form-data

bucket

string

可选

桶名称(最少1个字符，最大63个）

示例值:

tan

childFolder

string

可选

文件子目录(相对路径),为空则直接上传至桶的根目录下（最有一定要有斜杠）

示例值:

test/

file

文件流

可选

示例值:

file://H:\图片\logo.png

fileName

string

可选

业务自定义存储文件名,为空则使用系统默认规则

示例值:

测试

示例代码

Shell

JavaScript

Java

Swift

Go

PHP

Python

HTTP

C

C#

Objective-C

Ruby

OCaml

Dart

R

curl --location --request POST '/files/upload' \
--form 'bucket="tan"' \
--form 'childFolder="test/"' \
--form 'file=@"H:\\图片\\logo.png"' \
--form 'fileName="测试"'

返回响应

🟢200OK

application/json

Body

全局返回对象

code

integer <int32>

状态码

可选

message

string

接口消息

可选

ts

integer <int64>

时间戳

可选

traceId

string

可选

链路追踪ID(skywalking_traceId)

data

object (FileStorageVO)

文件元数据VO

可选

id

integer <int64>

id

可选

configId

integer <int64>

可选

配置id[FileConfig.id]

storage

string

可选

存储器[Dict.value] configId的冗余字段

originalName

string

原文件名

可选

freshName

string

新文件名

可选

path

string

可选

文件路径(存储在设备里的真实路径)

url

string

文件URL

可选

urlSuffix

string

可选

文件URL后缀[去除了url中的域名或者ip,那个在一些场合可以由前端自定义]

bucket

string

存储的桶

可选

type

string

可选

文件类型[contentType]

size

string

文件大小

可选

createTime

string

创建时间

可选

createUserName

string

创建者

可选

success

boolean

可选

示例

{
  "code": 200,
  "message": "成功",
  "ts": 1710749143858,
  "traceId": "14403052692722112",
  "data": {
    "id": 6,
    "configId": 7,
    "originalName": "logo.png",
    "freshName": "测试4.png",
    "path": "G:/test/detabes_files_2/tan/test/测试4.png",
    "url": "http://192.168.1.71:8200/files/tan/test/测试4.png",
    "bucket": "tan",
    "type": "image/png",
    "size": "27.66KB",
    "createTime": "2024-03-18 16:05:43",
    "createUserName": "admin"
  },
  "success": true
}

🟢200成功