オンボーディングガイド

PreviewFile.dev は 3 つの方法で安全なプレビューリンクを作成できます。ライトユーザー、ビジネスユーザー、開発者のどれでもすぐに始められます。

初めての方へ：このガイドは 3 つの利用シナリオを実例付きで案内します。

シナリオ 1: 直接 URL プレビュー（ログイン不要）

用途：元の URL を隠したまま、画像・動画・PDF などの Web リソースを素早く共有

手順

短縮リンクエンドポイントへアクセス

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

例：

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

プレビューリンクを取得
- 自動生成短縮リンク：/p/abc123xyz
- 完全 URL：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

# チームに短縮リンクを共有

メリット

✅ アカウント不要
✅ 即座にリンク生成
✅ 元 URL を非公開
✅ 自動有効期限

シナリオ 2: ブラウザでファイルアップロード（ログイン必須）

用途：ローカルファイルをオンラインで安全にプレビューし、高度なポリシーを設定

手順

トップページへ
- https://previewfile.dev を開く
- アップロードコンポーネントが表示
ドラッグ&ドロップ / 選択
- ドロップエリアにドラッグ、または「Upload File」をクリック
ログイン
- 初回アップロードでログインを要求
- GitHub / Google / Email で素早くサインイン
オプションのセキュリティ設定
- 有効期限：15 分 ~ 7 日（プラン制限、デフォルト 1 時間）
- 動的ウォーターマーク：テキストを重ねる
- ダウンロード禁止：閲覧のみ
- ワンタイムリンク：初回アクセスで失効
プレビューリンク生成
- 「安全なファイルプレビューリンクを生成」をクリック
- /p/[shortUrl] 形式の URL を取得
履歴管理
- ダッシュボードで作成済みセッションを閲覧
- 手動削除または自動期限切れを待つ

ユースケース例

例：デザイナーがクライアントに閲覧のみで共有

design-final.psd をアップロード
「No Download」を有効化
「Dynamic Watermark」を “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}')