# 策展 · X (Twitter) 🔥

> 📖 本站完整內容索引（documentation index）：[llms.txt](/llms.txt)

> 作者：Box (@Box) · 平台：X (Twitter) · 日期：2026-07-11

> 原始來源：https://x.com/Box/status/2075614124701364618

## 中文摘要

Box 透過 Box View API 讓開發者在應用程式內建安全的文件預覽與標註功能。

**核心功能**
Box 這項方案要解的是應用程式內嵌文件檢視器的安全性難題。透過 Box View，開發者能讓使用者直接在應用程式介面內預覽、標註並協作處理檔案，同時確保所有 Box 的權限控管與存取控制機制皆能嚴格執行。此架構的核心優勢在於資料治理，檔案無需下載至本地，確保敏感資料不會離開受控管的環境。

**實作流程**
根據演示內容，開發者可透過 API 整合文件處理流程，以下為具體操作步驟：

<video src="https://pub-75d4fe1e4e80421b9ecb1245a7ae0d1a.r2.dev/curated/1783728633668-wjf8yzfa.mp4" poster="https://pub-75d4fe1e4e80421b9ecb1245a7ae0d1a.r2.dev/curated/85bdb45305147f8e.jpg" controls playsinline preload="metadata" style="max-width:100%;height:auto;display:block;margin:1rem 0"></video>
> 展示如何透過 API 上傳文件並使用 Box 平台進行線上文件預覽與標註的操作流程。

1. 使用 `curl` 指令將文件上傳至 API 端點：
   ```bash
   curl -X POST http://127.0.0.1:5000/api/documents -F "file=@sample-tax-return.pdf"
   ```
   系統將回傳 `file_id`（例如 `2332874077879`）。
2. 透過瀏覽器存取對應的 API 端點進行檢視或標註：
   - 預覽文件：`http://127.0.0.1:5000/review/2332874077879`
   - 進入標註模式：`http://127.0.0.1:5000/annotate/2332874077879`
3. 在標註介面中，使用者可針對文件內容（如稅務申報表中的特定金額）進行圈選、標註並儲存，完成後透過介面上的按鈕確認編輯。

**技術架構**
在 demo 中出現的 API 介面設計，展示了標準化的文件處理路徑，包含以下關鍵端點：
- `/annotate`：提供文件預覽與標註功能。
- `/embed`：處理文件嵌入邏輯。
- `/token`：負責取得存取權限。
- `/health`：執行系統健康檢查。
- `/review`：提供文件預覽檢視。

這種整合方式不僅簡化了開發者的實作負擔，更透過 Box 的底層架構，在不犧牲使用者體驗的前提下，強化了企業級的文件安全防護。

## 媒體內容

**展示如何透過 API 上傳文件並使用 Box 平台進行線上文件預覽與標註的操作流程。**

**影片中的 Prompt 與操作**

操作步驟：

1. @00:03 在終端機輸入 curl 指令上傳 PDF 文件
2. @00:11 在瀏覽器網址列輸入 API 路徑
3. @00:21 修改網址路徑以進入標註介面
4. @00:28 點選標註工具並在文件上進行圈選與保存
5. OGFRAME: 00:39

## 標籤

SDK, 功能更新, Box