上传本地文件

POST

/api/upload

multipart 字段 file。默认最大 50MB（以 maxFileMB 为准）。返回源文件地址，再调用 /api/preview。源文件默认保留 24 小时，永久分享不延长源文件保留期。密钥使用 X-Preview-Key/Bearer 请求头。

请求参数

Body 参数multipart/form-data必填

请求示例代码

Shell

JavaScript

Java

Swift

PHP

Python

HTTP

Objective-C

Ruby

OCaml

Dart

返回响应

🟢201

application/json

上传本地文件

Bodyapplication/json

示例

{
    "id": "string",
    "name": "string",
    "url": "http://example.com",
    "size": 0,
    "expiresAt": "2019-08-24T14:15:22.123Z",
    "parentId": "string"
}

🟠400

🟠401

🟠403

🟠405

🟠413

🟠429

🔴500

修改于 2026-10-12 10:57:12

清除缓存/查询有效期