文件上傳

通用文件上傳能力:圖片/視頻/普通文件,白名單校驗並存儲到本地 /media,返回可訪問 URL。

/api/upload/

服務說明

文件上傳服務提供圖片、視頻與通用文件三類上傳入口,文件落盤到站點 /media 目錄並返回可直接引用的 URL,適合作為業務系統的統一附件通道。

全部接口使用 multipart/form-data,文件字段名固定為 file。服務端按白名單校驗擴展名並校驗文件頭(magic bytes),可內聯渲染或執行的文件類型(如 svg、html、腳本)一律拒絕,避免上傳文件被當作存儲型 XSS 利用。

體積限制:圖片最大 20MB,視頻與通用文件最大 100MB。本服務需項目簽名。

本地文件上傳

本地存儲(/media/uploads/…) 需簽名

全部使用 multipart/form-data,文件字段固定為 file;僅支持白名單類型並校驗文件頭(防偽裝/防腳本上傳)。

POST /api/upload/image 累計調用 2 次

上傳圖片

上傳圖片,返回可直接引用的圖片 URL。

multipart/form-data 文件字段 file:直接用下方「選擇文件」上傳即可。

  • 支持類型:jpg/jpeg/png/gif/bmp/webp/ico/tiff;最大 20MB。
  • svg 因可內嵌腳本已禁用。
  • 成功返回 data 字段:filename / original_name / size / size_mb / ext / type / relative_path / url。
  • 返回的 url 為站點媒體訪問地址(/media/...),可直接引用。
POST /api/upload/video 累計調用 0 次

上傳視頻

上傳視頻文件。

multipart/form-data 文件字段 file:直接用下方「選擇文件」上傳即可。

  • 最大 100MB;返回 type=video。
  • 成功返回 data 字段:filename / original_name / size / size_mb / ext / type / relative_path / url。
  • 返回的 url 為站點媒體訪問地址(/media/...),可直接引用。
POST /api/upload/file 累計調用 3 次

上傳通用文件

上傳通用文件(白名單:zip/pdf/docx/xlsx/txt 等)。

multipart/form-data 文件字段 file:直接用下方「選擇文件」上傳即可。

  • 最大 100MB;白名單制並校驗文件頭;返回 type=file。
  • 成功返回 data 字段:filename / original_name / size / size_mb / ext / type / relative_path / url。
  • 返回的 url 為站點媒體訪問地址(/media/...),可直接引用。
小影API · 通用 API 聚合服務