添加文件 - 上传文件

1. 接口说明

上传文件到 Nola 本地服务器或者对象存储。

2. 上传慢速优化

如果你是通过此接口上传文件到对象存储（OSS），同时服务器的网络带宽很小，可能导致上传时间过长，或者上传失败。
因为需要先将文件从本地上传到 Nola 服务器，然后 Nola 服务器又要对数据处理后再上传到对应的对象存储服务器，如果服务器进出带宽都很小，会导致此过程非常漫长。
但可以使用以下方式进行优化：

通过接口获取要上传到的文件组信息（如果需要分组）。

通过接口获取到对应的对象存储的密钥等配置信息。

在本地导入对应的对象存储的 SDK。

使用 SDK 在本地直接进行上传操作。

上传完成后，保存相关文件信息，并使用接口 “添加文件 - 添加记录” 将本次上传成功的文件信息记录到数据库。

这样一来，文件无需经过 Nola 服务器，直接从本地上传到对象存储服务器，然后仅需将文件信息提交到 Nola 服务器即可，解决了 Nola 服务器网络带宽小导致的上传问题。

请求参数

Authorization

在 Header 添加参数

Authorization

，其值为在 Bearer 之后拼接 Token

示例：

Authorization: Bearer ********************

Header 参数

Content-Type

string

必需

示例值:

multipart/form-data

Body 参数multipart/form-data

file

必需

要上传的文件（一次只能上传一个文件）

storageMode

enum<string>

存储策略

可选

枚举值:

LOCALTENCENT_COS

fileGroupId

integer

可选

要上传的文件组 ID

示例代码

Shell

JavaScript

Java

Swift

PHP

Python

HTTP

Objective-C

Ruby

OCaml

Dart

返回响应

🟢200成功

application/json

Body

code

integer

必需

errMsg

null

必需

data

object

必需

fileId

number

文件 ID

必需

fileGroupId

number | null

文件组 ID

必需

fileGroupName

string | null

文件组名

必需

displayName

string

文件名

必需

url

string

文件地址

必需

本地存储为相对地址，其他存储方式为绝对地址

size

number

文件大小

必需

storageMode

string

文件存储策略

必需

createTime

number

文件上传时间戳

必需

示例

上传成功文件存储策略未配置上传失败

{
    "code": 200,
    "errMsg": null,
    "data": {
        "fileId": 1,
        "fileGroupId": null,
        "fileGroupName": null,
        "displayName": "123.png",
        "url": "/upload/123.png",
        "size": 3340027,
        "storageMode": "LOCAL",
        "createTime": 1711622518884
    }
}

添加文件 - 上传文件

1. 接口说明#

2. 上传慢速优化#

请求参数

示例代码

返回响应

1. 接口说明

2. 上传慢速优化