跳转到主要内容
POST
上传的文件为临时文件,3天后自动删除。

功能特点

  • 支持多种文件类型的二进制流上传
  • 适合大文件上传,传输效率高
  • 自动识别 MIME 类型
  • 支持自定义文件名或使用原文件名
  • 返回完整的文件信息和下载链接
  • API Key 认证保护
  • 上传文件为临时文件,3天后自动删除

使用建议

  • 推荐用于大文件(>10MB)
  • 支持多种格式:图片、视频、文档等
  • 传输效率比 Base64 格式高约 33%

示例命令

授权

Authorization
string
header
必填

所有 API 需要通过 Bearer Token 进行身份验证。

获取 API Key:

  1. 访问 API Key 管理页面 获取您的 API Key

使用方法: 在请求头中添加: Authorization: Bearer YOUR_API_KEY

注意:

  • 请妥善保管您的 API Key,不要与他人分享
  • 如果怀疑 API Key 已泄露,请立即在管理页面重置

请求体

multipart/form-data
file
file
必填

要上传的文件(二进制数据)

uploadPath
string
必填

文件上传路径,不包含前后斜杠

示例:

"images/user-uploads"

fileName
string

文件名称(可选),包含文件扩展名。如不提供,系统将自动生成随机文件名。如果指定的文件名已存在,旧文件将被覆盖。注意:由于缓存机制,文件覆盖可能不会立即生效。

示例:

"my-image.jpg"

响应

文件上传成功

success
boolean
必填

请求是否成功

code
enum<integer>
必填

响应状态码

可用选项:
200,
400,
401,
405,
500
msg
string
必填

响应消息

示例:

"文件上传成功"

data
object