入門指南

PreviewFile.dev 提供三種核心方式建立安全的預覽連結，適合輕量用戶、企業用戶與開發者快速上手。

第一次使用？本指南會透過範例帶你完成三種常見情境。

情境 1：直接 URL 預覽（免登入）

適用：快速分享任意網頁資源（圖片、影片、PDF 等），隱藏原始網址

操作步驟

造訪短鏈生成端點

https://previewfile.dev/u?url=[YOUR_ORIGINAL_URL]

範例：

https://previewfile.dev/u?url=https://example.com/sensitive-document.pdf

取得預覽連結
- 系統自動生成短鏈：/p/abc123xyz
- 完整連結：https://previewfile.dev/p/abc123xyz
分享
- 訪問 /p/abc123xyz 即可查看
- 原始 URL 完全隱藏
- 連結依配置自動過期（預設 1 小時）

範例情境

用例：分享公司內部報告且不暴露 S3 路徑

# 瀏覽器輸入
https://previewfile.dev/u?url=https://s3.company.com/reports/Q3-2025.pdf

# 回傳短鏈
https://previewfile.dev/p/x7k2m9n

# 將短鏈分享給團隊

優勢

✅ 無需註冊登入
✅ 立即生成預覽連結
✅ 隱藏原始地址
✅ 自動過期保護

情境 2：瀏覽器上傳檔案（需登入）

適用：上傳本地檔案線上預覽，並配置進階安全策略

操作步驟

造訪首頁
- 開啟 https://previewfile.dev
- 看到上傳元件
拖曳/選取檔案
- 拖到上傳區域，或點擊「上傳檔案」
登入提示
- 首次上傳會要求登入
- 支援 GitHub / Google / 信箱快捷登入
可選安全策略
- 有效期：15 分鐘 ~ 7 天（受方案限制，預設 1 小時）
- 動態浮水印：加入水印文字
- 禁止下載：僅可線上檢視
- 一次性連結：訪問一次即失效
生成預覽連結
- 點擊「生成預覽連結」
- 獲得 /p/[shortUrl] 地址
管理紀錄
- 在 Dashboard 查看歷史預覽
- 手動刪除或等候自動過期

範例情境

用例：設計師向客戶分享只讀設計稿

上傳 design-final.psd
勾選「禁止下載」
將「動態浮水印」設為「Client Preview Only」
設定有效期 24 小時
取得連結 https://previewfile.dev/p/d3s1gn42
客戶只能線上查看，無法下載原稿

優勢

✅ 支援本地檔案上傳
✅ 彈性安全策略
✅ 登入後可統一管理紀錄
✅ 適合企業內部協作

情境 3：開發者 API 整合

適用：在應用中整合檔案預覽，批次生成預覽連結

端點

POST /api/u
Content-Type: application/json
x-api-key: YOUR_API_KEY

請求範例

{
  "url": "https://example.com/document.pdf",
  "ttlMinutes": 60,
  "watermark": "Confidential",
  "noDownload": true,
  "oneTime": false
}

回應範例

{
  "success": true,
  "data": {
    "shortUrl": "a1b2c3d4",
    "previewUrl": "https://previewfile.dev/p/a1b2c3d4",
    "expireAt": "2025-10-02T15:30:00Z",
    "status": "READY"
  }
}

整合示例

Node.js

const fetch = require('node-fetch');

async function createPreview(originalUrl) {
  const response = await fetch('https://previewfile.dev/api/u', {
    method: 'POST',
    headers: {
      'Content-Type': 'application/json',
      'Authorization': `Bearer ${process.env.PREVIEWFILE_API_KEY}`
    },
    body: JSON.stringify({
      url: originalUrl,
      ttlMinutes: 120,
      noDownload: true
    })
  });

  const result = await response.json();
  return result.data.previewUrl;
}

// 使用
const previewLink = await createPreview('https://cdn.company.com/invoice-2025.pdf');
console.log('Preview link:', previewLink);

Python

import requests

def create_preview(original_url):
    response = requests.post(
        'https://previewfile.dev/api/u',
        headers={
            'Content-Type': 'application/json',
            'Authorization': f'Bearer {API_KEY}'
        },
        json={
            'url': original_url,
            'ttlMinutes': 120,
            'noDownload': True
        }
    )
    data = response.json()
    return data['data']['previewUrl']

# 使用
preview_link = create_preview('https://cdn.company.com/invoice-2025.pdf')
print(f'Preview link: {preview_link}')