文件上传

POST

/api/system/upload/file

Controller: Modules\System\Http\Controllers\Api\UploadController::file

本接口允许游客访问，登录态可选（api.try-auth）。

请求参数

Authorization

Bearer Token

在 Header 添加参数

Authorization

，其值为在 Bearer 之后拼接 Token

示例：

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

Body 参数application/json必填

示例

{
    "cid": 0,
    "module": "string",
    "tag": "string",
    "nanoid": "string",
    "type": "image",
    "engine": "local",
    "file": "string"
}

请求示例代码

Shell

JavaScript

Java

Swift

PHP

Python

HTTP

Objective-C

Ruby

OCaml

Dart

curl --location '/api/system/upload/file' \
--header 'Authorization: Bearer <token>' \
--header 'Content-Type: application/json' \
--data '{
    "cid": 0,
    "module": "string",
    "tag": "string",
    "nanoid": "string",
    "type": "image",
    "engine": "local",
    "file": "string"
}'

返回响应

🟢200

application/json

业务响应

Bodyapplication/json

示例

{
    "code": 200,
    "message": "",
    "data": null
}

修改于 2026-05-22 06:30:49

发送验证码

验证上传规则