列表记忆版本-Qoder CN 系列(Lingma)-阿里云帮助中心

获取指定 Memory Store 下所有记忆条目的版本历史记录。

请求头

头部	必选	说明
`Authorization`	是	`Bearer`

路径参数

参数	类型	必选	说明
`memory_store_id`	string	是	Memory Store ID（`memstore_` 前缀）

查询参数

参数	类型	必选	说明
`limit`	integer	否	每页返回数量上限
`after_id`	string	否	游标分页：返回此 ID 之后的记录
`before_id`	string	否	游标分页：返回此 ID 之前的记录

完整分页规范详见分页。

示例请求

curl -X GET "https://api.qoder.com.cn/api/v1/cloud/memory_stores/memstore_xxx/versions" \
  -H "Authorization: Bearer $QODER_PAT"

# 分页
curl -X GET "https://api.qoder.com.cn/api/v1/cloud/memory_stores/memstore_xxx/versions?limit=2&after_id=memver_xxx" \
  -H "Authorization: Bearer $QODER_PAT"

示例响应

HTTP 200 OK

{
  "data": [
    {
      "id": "memver_019e3bb9e5197b0c816e621050a8394e",
      "type": "memory_version",
      "store_id": "memstore_019e3bb93b7074f9a5130d39ddcca90f",
      "entry_id": "mem_019e3bb9cf417d7dbb11fe9784dbb65c",
      "entry_path": "versions/test.md",
      "action": "updated",
      "size": 27,
      "content_sha256": "ff1328301132f954eeac24cd379ab7f6f5a540573bfe3eb2db3995abe3678210",
      "redacted": false,
      "created_at": "2026-05-18T15:34:59.125612Z"
    },
    {
      "id": "memver_019e3bb9cf417d89970ba7f45e728c56",
      "type": "memory_version",
      "store_id": "memstore_019e3bb93b7074f9a5130d39ddcca90f",
      "entry_id": "mem_019e3bb9cf417d7dbb11fe9784dbb65c",
      "entry_path": "versions/test.md",
      "action": "created",
      "size": 17,
      "content_sha256": "fe80a065cb120813abf7dfceb4018a53d6eb7140c785181634e019656176c64e",
      "redacted": false,
      "created_at": "2026-05-18T15:34:53.528628Z"
    },
    {
      "id": "memver_019e3bb9a511741f89f28d5e7efb7844",
      "type": "memory_version",
      "store_id": "memstore_019e3bb93b7074f9a5130d39ddcca90f",
      "entry_id": "mem_019e3bb965a671fca51bde1cf8d87de0",
      "entry_path": "test/note.md",
      "action": "deleted",
      "size": 0,
      "content_sha256": "",
      "redacted": false,
      "created_at": "2026-05-18T15:34:42.707852Z"
    }
  ],
  "first_id": "memver_019e3bb9e5197b0c816e621050a8394e",
  "last_id": "memver_019e3bb9a511741f89f28d5e7efb7844",
  "has_more": false
}

响应字段

字段	类型	说明
`data`	array	MemoryVersion 对象数组（不含 `content`）
`first_id`	string	当前页第一条记录 ID
`last_id`	string	当前页最后一条记录 ID
`has_more`	boolean	是否还有更多数据

列表中单条记录字段：

字段	类型	说明
`id`	string	版本唯一标识符（`memver_` 前缀）
`type`	string	固定值 `"memory_version"`
`store_id`	string	所属 Store ID
`entry_id`	string	关联的记忆条目 ID
`entry_path`	string	关联记忆条目的路径
`action`	string	操作类型：`"created"` / `"updated"` / `"deleted"`
`size`	int64	该版本内容大小（`deleted` 时为 0）
`content_sha256`	string	该版本内容哈希（`deleted` 时为空）
`redacted`	boolean	是否已被遮蔽
`redacted_at`	string	遮蔽时间（仅 `redacted=true` 时存在）
`created_at`	string	版本创建时间（ISO 8601）

错误码

HTTP	type	触发条件
401	`authentication_error`	未提供或无效的认证令牌
404	`not_found_error`	指定的 Memory Store 不存在

注意事项

版本记录包含所有记忆条目的变更历史（创建、更新、删除）
列表接口不返回 content 字段
按时间倒序排列（最新操作在前）
action: "deleted" 的版本记录中 size 为 0，content_sha256 为空字符串
被 redact 的版本在列表中会显示 redacted: true 和 redacted_at

完整错误信封说明详见错误参考。