API 總覽
API Overview

API 共有 10 個路由器、42 個端點。/api/v1/* 下的所有端點均需 X-API-Key 認證。

The API has 10 routers and 42 endpoints. All endpoints under /api/v1/* require X-API-Key authentication.

端點總覽
Endpoints Summary

健康檢查
Health Check

QA 知識庫 — 4 個端點
QA Knowledge Base — 4 endpoints

QA 篩選參數 / QA Filters:

• category — 依 SEO 分類篩選（例如 "Technical SEO"、"Content Strategy"）
  Filter by SEO category (e.g. "Technical SEO", "Content Strategy")
• keyword — 全文關鍵字搜尋 / Full-text keyword search
• difficulty — basic / advanced
• evergreen — true / false
• source_type — meeting / article
• source_collection — 指定 Collection 名稱 / Specific collection name
• maturity_relevance — L1 / L2 / L3 / L4
• limit / offset — 分頁 / Pagination
• sort_by / sort_order — 排序 / Sorting

搜尋 — 1 個端點
Search — 1 endpoint

請求 Body / Request body:

{
  "query": "How to optimize Core Web Vitals?",
  "top_k": 5,
  "category": "Technical SEO"
}

對話 — 1 個端點
Chat — 1 endpoint

請求 Body / Request body:

{
  "message": "What is canonical URL?",
  "history": [],
  "mode": "rag"
}

對話管理 — 5 個端點
Sessions — 5 endpoints

週報 — 3 個端點
Reports — 3 endpoints

回饋 — 1 個端點
Feedback — 1 endpoint

同義詞 — 4 個端點
Synonyms — 4 endpoints

Pipeline 管理 — 18 個端點
Pipeline — 18 endpoints

會議準備 — 3 個端點
Meeting Prep — 3 endpoints

回應格式
Response Format

所有 API 回應均遵循一致的 JSON 結構：

All API responses follow a consistent JSON structure:

{
  "data": { ... },
  "error": null,
  "meta": {
    "request_id": "uuid",
    "version": "3.4.0"
  }
}

錯誤回應
Error Responses

{
  "error": "Validation failed",
  "details": "message: String must contain at least 1 character(s)"
}