Skip to main content
POST
Base64 File Upload

授权

Authorization
string
header
必填

所有接口均需要使用Bearer Token进行认证

使用时在请求头中添加:

Authorization: Bearer YOUR_API_KEY

请求体

application/json
file_data
string
必填

Base64 编码的文件内容,支持纯 base64 或 data URL 格式

示例:

"iVBORw0KGgoAAAANSUhEUgAAAAEAAAABCAYAAAAfFcSJAAAADUlEQVR42mNk..."

file_name
string

文件名(含扩展名),不提供时从 data URL MIME 推断或默认 upload.bin

示例:

"photo.png"

auto_cleanup
boolean
默认值:true

存储空间不足时是否自动清理最早上传的文件以腾出空间

说明:

  • 默认 true:自动淘汰最早上传的文件
  • 设为 false:空间不足时直接返回 403 错误
示例:

true

响应

文件上传成功

id
string

文件ID

示例:

"file-1757165031-a1b2c3"

filename
string

原始文件名

示例:

"photo.png"

url
string

上传文件的可访问URL

示例:

"https://cdn.foxapi.cc/uploads/20260319/a1b2c3d4e5f6/photo.png"

size
integer

文件大小(字节)

示例:

204800

created
integer

上传时间戳

示例:

1757165031