文件上传 API

基础地址:https://viewer.50kfc.cc。所有上传接口通过 X-Upload-Key 请求头验证密钥。文件上传到腾讯云 COS,分享链接 30 天后失效。

1. 验证密钥

curl -X POST https://viewer.50kfc.cc/upload/api/verify \
  -H "X-Upload-Key: gumiao"

成功响应:{"valid":true};密钥错误返回 HTTP 401。

2. 上传文件并取得公开地址

curl -X POST https://viewer.50kfc.cc/upload/api \
  -H "X-Upload-Key: gumiao" \
  -F "file=@/本地路径/示例.docx"

支持 md、markdown、pdf、doc/docx、xls/xlsx、ppt/pptx,单文件最大 100 MB。成功后会返回 preview_url 和 download_url,两者均为公开地址,30 天后自动失效。

响应示例

{
  "id": "随机文件标识",
  "name": "示例.docx",
  "size": 12345,
  "cos_preview_url": "https://bucket.cos...?...ci-process=doc-preview...",
  "browser_preview_url": "https://viewer.50kfc.cc/iframe.html?...",
  "download_url": "https://viewer.50kfc.cc/api/files/.../download",
  "expires_in_days": 30
}