資源

API 更新紀錄

v1.0 — 2026-04-10

首次發布 API 文件。

V1 LLM API

  • GET /v1/graph/search/ — 依標題搜尋節點
  • GET /v1/graph/nodes/<id>/ — 取得節點詳細資訊
  • GET /v1/graph/content/<id>/ — 取得頁面內容（markdown）
  • GET /v1/graph/neighbors/<id>/ — 以 BFS 走訪相鄰節點
  • POST /v1/graph/traverse/ — 節點之間的最短路徑
  • GET /v1/ — 自我描述式 API 規格（無需身分驗證）

圖譜 API

  • GET /api/notion-graph/ — 完整圖譜資料（節點 + 邊）

搜尋 API

  • GET /api/search/ — 全文搜尋（BM25）
  • GET /api/search/suggest/ — 自動完成
  • GET /api/search/semantic/ — 向量相似度搜尋
  • GET /api/search/hybrid/ — BM25 + 向量搜尋
  • GET /api/search/similar/<id>/ — 尋找相似節點
  • GET /api/search/content/<id>/ — 頁面內容

身分驗證

  • 使用服務權杖（ivg_*）存取 V1 API
  • 使用者透過 Notion OAuth 以 JWT 存取 API

公開端點

  • GET /api/stats/public/ — 平台統計資料
  • GET /api/health/ — 健康檢查