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

docs/API_ENDPOINTS.md

@@ -4,7 +4,7 @@
 |------|------|
 | 建立者 | Warren |
 | 建立時間 | 2026-03-18 |
-| 文件版本 | V1.2 |
+| 文件版本 | V1.3 |
 
 ---
 
@@ -15,6 +15,7 @@
 | V1.0 | 2026-03-18 | 創建文件 | OpenCode |
 | V1.1 | 2026-03-23 | 更新端點與實際一致 | OpenCode |
 | V1.2 | 2026-03-25 | 新增快取/刪除 API | OpenCode |
+| V1.3 | 2026-03-26 | 更新API回應格式 (media_url→file_path) | OpenCode |
 
 ---
 
@@ -81,6 +82,7 @@ curl http://localhost:3002/health
 ```bash
 curl -X POST http://localhost:3002/api/v1/search \
   -H "Content-Type: application/json" \
+  -H "X-API-Key: your-api-key" \
   -d '{"query": "test", "limit": 10}'
 ```
 
@@ -88,6 +90,7 @@ curl -X POST http://localhost:3002/api/v1/search \
 ```bash
 curl -X POST http://localhost:3002/api/v1/n8n/search \
   -H "Content-Type: application/json" \
+  -H "X-API-Key: your-api-key" \
   -d '{"query": "test", "limit": 10}'
 ```
 
@@ -107,13 +110,29 @@ curl -X POST http://localhost:3002/api/v1/n8n/search \
 ```bash
 curl -X POST http://localhost:3002/api/v1/register \
   -H "Content-Type: application/json" \
+  -H "X-API-Key: your-api-key" \
   -d '{"path": "/path/to/video.mp4"}'
 ```
 
+**註冊回應範例**:
+```json
+{
+  "uuid": "a1b10138a6bbb0cd",
+  "video_id": 1,
+  "job_id": 10,
+  "file_name": "video.mp4",
+  "duration": 120.5,
+  "width": 1920,
+  "height": 1080,
+  "already_exists": false
+}
+```
+
 **探測影片** (不註冊，只取得影片資訊):
 ```bash
 curl -X POST http://localhost:3002/api/v1/probe \
   -H "Content-Type: application/json" \
+  -H "X-API-Key: your-api-key" \
   -d '{"path": "./demo/video.mp4"}'
 ```
 
@@ -150,17 +169,36 @@ curl -X POST http://localhost:3002/api/v1/probe \
 
 **列出影片**:
 ```bash
-curl http://localhost:3002/api/v1/videos
+curl -H "X-API-Key: your-api-key" http://localhost:3002/api/v1/videos
 ```
 
 **查詢影片**:
 ```bash
-curl "http://localhost:3002/api/v1/lookup?uuid=5dea6618a606e7c7"
+curl -H "X-API-Key: your-api-key" "http://localhost:3002/api/v1/lookup?uuid=5dea6618a606e7c7"
 ```
 
 **處理進度**:
 ```bash
-curl http://localhost:3002/api/v1/progress/5dea6618a606e7c7
+curl -H "X-API-Key: your-api-key" http://localhost:3002/api/v1/progress/5dea6618a606e7c7
+```
+
+---
+
+### 工作管理
+
+| 方法 | 端點 | 說明 |
+|------|------|------|
+| GET | `/api/v1/jobs` | 列出所有工作 |
+| GET | `/api/v1/jobs/:uuid` | 取得指定工作的詳細資訊 |
+
+**列出工作**:
+```bash
+curl -H "X-API-Key: your-api-key" http://localhost:3002/api/v1/jobs
+```
+
+**取得工作詳細資訊**:
+```bash
+curl -H "X-API-Key: your-api-key" http://localhost:3002/api/v1/jobs/a03485a40b2df2d3
 ```
 
 ---
@@ -176,6 +214,7 @@ curl http://localhost:3002/api/v1/progress/5dea6618a606e7c7
 ```bash
 curl -X POST http://localhost:3002/api/v1/config/cache \
   -H "Content-Type: application/json" \
+  -H "X-API-Key: your-api-key" \
   -d '{"enabled": true}'
 ```
 
@@ -183,6 +222,7 @@ curl -X POST http://localhost:3002/api/v1/config/cache \
 ```bash
 curl -X POST http://localhost:3002/api/v1/unregister \
   -H "Content-Type: application/json" \
+  -H "X-API-Key: your-api-key" \
   -d '{"uuid": "5dea6618a606e7c7"}'
 ```
 
@@ -199,6 +239,7 @@ curl -X POST http://localhost:3002/api/v1/unregister \
 | 列出影片 | ✓ | ✓ | ✓ |
 | 查詢影片 | ✓ | ✓ | ✓ |
 | 處理進度 | ✓ | ✓ | ✓ |
+| 工作管理 | ✓ | ✓ | ✓ |
 | 快取設定 | ✓ (管理員) | ✓ (管理員) | ✓ (管理員) |
 | 刪除影片 | ✓ (管理員) | ✓ (管理員) | ✓ (管理員) |
 
@@ -220,7 +261,7 @@ curl -X POST http://localhost:3002/api/v1/unregister \
       "title": "Chunk sentence_0001",
       "text": "...",
       "score": 0.92,
-      "media_url": "https://wp.momentry.ddns.net/video.mp4"
+      "file_path": "/Users/accusys/momentry/var/sftpgo/data/demo/video.mp4"
     }
   ]
 }