From 607ce2c7c50b57782e067b5233fe0ca209e1602e Mon Sep 17 00:00:00 2001
From: API Changelog Bot <changelog@hulalv.com>
Date: Mon, 23 Mar 2026 20:33:18 +0800
Subject: [PATCH] =?UTF-8?q?changelog:=20=E7=AE=A1=E7=90=86=E7=AB=AF?=
 =?UTF-8?q?=E6=96=87=E4=BB=B6=E9=A2=84=E8=A7=88=E6=8E=A5=E5=8F=A3=E4=BD=BF?=
 =?UTF-8?q?=E7=94=A8=E8=AF=B4=E6=98=8E?=
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit

返回HTML页面，前端用window.open或iframe打开，不能用fetch。

Co-Authored-By: Claude Opus 4.6 (1M context) <noreply@anthropic.com>
---
 .../2026-03/2026-03-23_admin_file_preview.md  | 47 +++++++++++++++++++
 1 file changed, 47 insertions(+)
 create mode 100644 changelogs/2026-03/2026-03-23_admin_file_preview.md

diff --git a/changelogs/2026-03/2026-03-23_admin_file_preview.md b/changelogs/2026-03/2026-03-23_admin_file_preview.md
new file mode 100644
index 0000000..acb85e6
--- /dev/null
+++ b/changelogs/2026-03/2026-03-23_admin_file_preview.md
@@ -0,0 +1,47 @@
+# 管理端文件预览接口使用说明
+
+**日期**: 2026-03-23
+
+---
+
+## 接口
+
+```
+GET /admin/file/preview-by-url?url=编码后的完整OSS_URL
+```
+
+**无需登录**（已排除认证）
+
+## 正确使用方式
+
+**这个接口返回的是 HTML 页面，不是 JSON。前端不能用 fetch/axios 调用。**
+
+### 方式1：新窗口打开（推荐）
+```javascript
+const previewUrl = `/admin/file/preview-by-url?url=${encodeURIComponent(ossUrl)}`;
+window.open(previewUrl, '_blank');
+```
+
+### 方式2：iframe 嵌入
+```html
+<iframe :src="`/admin/file/preview-by-url?url=${encodeURIComponent(ossUrl)}`"
+        width="100%" height="600px" />
+```
+
+### 方式3：弹窗内 iframe
+```javascript
+// 弹窗打开时设置 iframe src
+dialogVisible.value = true;
+iframeSrc.value = `/admin/file/preview-by-url?url=${encodeURIComponent(ossUrl)}`;
+```
+
+## 支持的文件类型
+- PDF：内嵌 PDF.js 渲染
+- 图片：直接 img 标签显示
+- Office 文档：跳转在线预览服务
+
+## 如果需要原始二进制流（img src 等场景）
+```
+GET /admin/file/stream-by-url?url=编码后的URL
+```
+返回原始文件内容，适合 `<img src="">` 或 `<video src="">` 直接引用。