## v0.9.20260325_144654 ### Features - API Key Authentication System - Job Worker System - V2 Backup Versioning ### Bug Fixes - get_processor_results_by_job column mapping Co-authored-by: OpenCode
2.7 KiB
2.7 KiB
Momentry Core API 文件總覽
| 項目 | 內容 |
|---|---|
| 版本 | V2.1 |
| 日期 | 2026-03-25 |
文件架構
docs/
├── API_INDEX.md ← 本文件:總覽與入口
├── API_ENDPOINTS.md ← API 端點完整說明
├── API_EXAMPLES.md ← 完整範例總覽(curl / n8n / WordPress)
├── DEMO_MANUAL.md ← ⭐ 示範手冊(含 Demo API Key)
├── API_N8N_GUIDE.md ← n8n 詳細指南
├── API_WORDPRESS_GUIDE.md ← WordPress 詳細指南
├── API_CURL_EXAMPLES.md ← curl 快速範例
└── API_REFERENCE.md ← 詳細技術參考
快速選擇指南
| 需求 | 閱讀文件 |
|---|---|
| 我要快速開始測試 | ⭐ DEMO_MANUAL.md |
| 我要查看所有範例 | API_EXAMPLES.md |
| 我想了解有哪些 API 端點 | API_ENDPOINTS.md |
| 我要在 n8n workflow 中呼叫 API | DEMO_MANUAL.md |
| 我要在 WordPress 中呼叫 API | DEMO_MANUAL.md |
| 我要用 curl 快速測試 | DEMO_MANUAL.md |
認證
Demo API Key
API Key: muser_68600856036340bcafc01930eb4bd839_1774418104_97221b69
Key ID: muser_68600856036340bcafc01930eb4bd839
過期日: 2027-03-25
使用方式
curl -H "X-API-Key: muser_68600856036340bcafc01930eb4bd839_1774418104_97221b69" \
http://localhost:3002/api/v1/videos
API URL 選擇
| 環境 | URL | 使用時機 |
|---|---|---|
| 本地開發 | http://localhost:3002 |
開發/測試、繞過反向代理 |
| 外部訪問 | https://api.momentry.ddns.net |
n8n、WordPress、遠端系統 |
何時用哪個
使用 localhost:3002:
- 本地終端機測試
- 當反向代理有問題時
- 快速除錯
使用 api.momentry.ddns.net:
- n8n workflow
- WordPress 網站
- 外部系統整合
常見問題
Q: API 返回 401 錯誤?
API Key 無效或過期。請使用 Demo API Key 或建立新的 API Key。
Q: API 返回 502 錯誤?
# 檢查服務狀態
launchctl list | grep momentry.api
# 如未啟動
sudo launchctl load /Library/LaunchDaemons/com.momentry.api.plist
Q: 兩個 URL 功能相同嗎?
是的,所有端點完全相同,只是訪問路徑不同。
相關文件
- DEMO_MANUAL.md - ⭐ 示範手冊(推薦新手)
- INSTALL_MOMENTRY_API.md - API 服務安裝指南
- PENDING_ISSUES.md - 待解決問題追蹤