REST API 參考

所有端點都需要 Bearer 權杖驗證。從控制台取得你的權杖。

# 基礎 URL

https://api.agent-memo.ai

# 驗證標頭

Authorization: Bearer YOUR_API_KEY

記憶

GET/api/memories

列出記憶，支援選用篩選條件

Query: ?topic=&type=&importance=&limit=&offset=

POST/api/memories

建立一筆新記憶

{ "content": "...", "type": "project", "topic": "auth", "importance": 2, "tags": ["decision"] }

GET/api/memories/:id

按 ID 取得單筆記憶

PUT/api/memories/:id

更新已有記憶

{ "content": "updated content", "importance": 3 }

DELETE/api/memories/:id

刪除一筆記憶

POST/api/memories/search

跨記憶語意搜尋

{ "query": "database choice", "type": ["project"], "limit": 5 }

GET/api/memories/topics

列出所有主題及記憶數量

POST/api/memories/check-duplicate

儲存前檢查語意重複

{ "content": "...", "threshold": 0.92 }

POST/api/kg/add

新增實體關係（事實）

{ "subject": "auth-service", "predicate": "uses", "object": "JWT", "confidence": 0.95 }

POST/api/kg/query

查詢實體關係

{ "entity": "auth-service", "direction": "outgoing" }

POST/api/kg/invalidate

使事實失效（標記為不再有效）

{ "factId": "..." }

POST/api/kg/timeline

檢視實體的事實時間軸

{ "entity": "auth-service" }

GET/api/kg/stats

知識圖譜統計

所有回應均為 JSON 格式。成功回應直接回傳資料。錯誤回應回傳包含 error 欄位的 JSON 物件。

成功（200）

{
  "id": "abc-123",
  "content": "Use PostgreSQL",
  "type": "project",
  "topic": "database",
  "importance": 3,
  "created_at": "2026-04-08T..."
}

錯誤（4xx/5xx）

{
  "error": "Memory not found"
}

Beta 期間沒有強制的速率限制。請合理使用——典型用量遠低於每分鐘 100 次請求。付費方案推出後將引入速率限制。