feat: 新增 Job Worker 系統與 API 文檔全面更新

docs/API_N8N_GUIDE.md

@@ -2,9 +2,22 @@
 
 | 項目 | 內容 |
 |------|------|
-| 版本 | V1.0 |
-| 日期 | 2026-03-23 |
-| 用途 | 在 n8n workflow 中呼叫 Momentry API |
+| 建立者 | Warren |
+| 建立時間 | 2026-03-23 |
+| 文件版本 | V1.1 |
+
+---
+
+## 版本歷史
+
+| 版本 | 日期 | 目的 | 操作人 | 工具/模型 |
+|------|------|------|--------|-----------|
+| V1.0 | 2026-03-23 | 創建文件 | Warren | OpenCode / MiniMax M2.5 |
+| V1.1 | 2026-03-26 | 新增 API Key 驗證說明，更新 HTTP Request Node 設定 | OpenCode | deepseek-reasoner |
+
+---
+
+**用途**: 在 n8n workflow 中呼叫 Momentry API
 
 ---
 
@@ -29,6 +42,8 @@ https://api.momentry.ddns.net
 | GET | `/api/v1/videos` | 列出所有影片 |
 | GET | `/api/v1/lookup` | 查詢影片 |
 | GET | `/api/v1/progress/:uuid` | 處理進度 |
+| GET | `/api/v1/jobs` | 任務列表 |
+| GET | `/api/v1/jobs/:uuid` | 任務詳情 |
 
 ---
 
@@ -43,11 +58,14 @@ Node: HTTP Request
 ├── Authentication: None
 ├── Send Body: ✓ (checked)
 ├── Content Type: JSON
-└── Body:
-    {
-      "query": "={{ $json.query }}",
-      "limit": "={{ $json.limit || 10 }}"
-    }
+├── Body:
+│   {
+│     "query": "={{ $json.query }}",
+│     "limit": "={{ $json.limit || 10 }}"
+│   }
+├── Send Headers: ✓ (checked)
+└── Header Parameters:
+    └── X-API-Key: {{ $env.MOMENTRY_API_KEY }}
 ```
 
 ### 測試用（固定關鍵字）
@@ -58,11 +76,14 @@ Node: HTTP Request
 ├── Method: POST
 ├── Send Body: ✓
 ├── Content Type: JSON
-└── Body:
-    {
-      "query": "charade",
-      "limit": 3
-    }
+├── Body:
+│   {
+│     "query": "charade",
+│     "limit": 3
+│   }
+├── Send Headers: ✓ (checked)
+└── Header Parameters:
+    └── X-API-Key: {{ $env.MOMENTRY_API_KEY }}
 ```
 
 ---
@@ -174,13 +195,21 @@ sudo launchctl load /Library/LaunchDaemons/com.momentry.api.plist
 
 在終端機中測試 API：
 
+> **注意**: 所有 `/api/v1/*` 端點都需要 API Key 驗證。請設定環境變數或直接替換 API Key。
+
+```bash
+# 設定環境變數（使用您的 API Key）
+export MOMENTRY_API_KEY="muser_68600856036340bcafc01930eb4bd839_1774418104_97221b69"
+```
+
 ```bash
 # 健康檢查
 curl https://api.momentry.ddns.net/health
 
-# 搜尋測試
+# 搜尋測試 (需要 API Key)
 curl -X POST https://api.momentry.ddns.net/api/v1/n8n/search \
   -H "Content-Type: application/json" \
+  -H "X-API-Key: $MOMENTRY_API_KEY" \
   -d '{"query":"charade","limit":3}'
 ```