From 70cf4ac59b41faf8f75d5177fbc46b8660344b56 Mon Sep 17 00:00:00 2001
From: API Changelog Bot <changelog@hulalv.com>
Date: Mon, 23 Mar 2026 20:45:32 +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=E6=9B=B4?=
 =?UTF-8?q?=E6=96=B0=EF=BC=88=E8=BF=94=E5=9B=9E=E5=8E=9F=E5=A7=8B=E4=BA=8C?=
 =?UTF-8?q?=E8=BF=9B=E5=88=B6=E6=B5=81=EF=BC=89?=
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit

preview-by-url 现在返回原始文件流（与/{fileId}/preview一致），前端用iframe直接显示。

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

diff --git a/changelogs/2026-03/2026-03-23_admin_file_preview_v2.md b/changelogs/2026-03/2026-03-23_admin_file_preview_v2.md
new file mode 100644
index 0000000..ac7021d
--- /dev/null
+++ b/changelogs/2026-03/2026-03-23_admin_file_preview_v2.md
@@ -0,0 +1,37 @@
+# 管理端文件预览接口（更新）
+
+**日期**: 2026-03-23
+**类型**: 接口更新
+
+---
+
+## 接口
+
+```
+GET /admin/file/preview-by-url?url=编码后的完整OSS_URL
+```
+
+**无需登录，无需 token。**
+
+## 返回内容
+
+直接返回**原始文件二进制流**（与 `/{fileId}/preview` 一致）：
+- PDF → Content-Type: application/pdf
+- 图片 → Content-Type: image/jpeg 等
+- 其他 → 对应 MIME 类型
+
+## 前端使用
+
+```javascript
+// iframe 嵌入（推荐，PDF和图片都能直接显示）
+<iframe :src="`/api/admin/file/preview-by-url?url=${encodeURIComponent(ossUrl)}`"
+        width="100%" height="600px" />
+
+// 或新窗口打开
+window.open(`/api/admin/file/preview-by-url?url=${encodeURIComponent(ossUrl)}`)
+
+// 或 img 标签（仅图片）
+<img :src="`/api/admin/file/preview-by-url?url=${encodeURIComponent(ossUrl)}`" />
+```
+
+**注意**：url 参数必须 `encodeURIComponent` 编码。