本地接口测试

本页记录本地开发环境中可直接复制的接口测试命令。

测试环境

export MEMASTER_BASE_URL="http://localhost:8888"
export MEMASTER_API_KEY="msk_UFaL1XiC1ur5sl8p3rOjv8-Dxs1f6IKiRjXc1NztcHs"

健康检查

curl "$MEMASTER_BASE_URL/openapi.json"

查询记忆

curl "$MEMASTER_BASE_URL/memories?user_id=docs_local_test" \
  -H "X-API-Key: $MEMASTER_API_KEY"

写入测试记忆

curl -X POST "$MEMASTER_BASE_URL/memories" \
  -H "X-API-Key: $MEMASTER_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "user_id": "docs_local_test",
    "infer": true,
    "messages": [
      {"role":"user","content":"本地文档接口测试：我偏好中文回复。"}
    ],
    "metadata": {
      "project": "docs",
      "source": "local-test",
      "tags": ["docs", "local-test"]
    }
  }'

infer: true 会让服务端先调用 LLM 抽取稳定记忆并去重；本地测试时需要确保服务端环境中配置了可用的 OPENAI_API_KEY。如果未配置，服务端会回退为原文写入，并在返回的 metadata 中带上 infer_fallback_reason。

检索测试记忆

curl -X POST "$MEMASTER_BASE_URL/search" \
  -H "X-API-Key: $MEMASTER_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "query": "本地测试用户偏好什么语言回复？",
    "user_id": "docs_local_test",
    "top_k": 3
  }'

查询用量

curl "$MEMASTER_BASE_URL/usage" \
  -H "X-API-Key: $MEMASTER_API_KEY"

查询请求日志

curl "$MEMASTER_BASE_URL/requests?limit=5&offset=0" \
  -H "X-API-Key: $MEMASTER_API_KEY"

注意事项

API Key 调用 Memory API 使用 X-API-Key 请求头。
Authorization: Bearer <access_token> 用于 Dashboard 登录态接口，例如 /api-keys。
写入和检索会消耗本地账号配额。
测试数据使用 user_id=docs_local_test，便于后续清理或过滤。

概览 Memories