获取记忆版本

更新时间:
复制为 MD 格式

根据版本 ID 获取单条版本的详细信息(包含内容)。

请求头

头部

必选

说明

Authorization

Bearer

路径参数

参数

类型

必选

说明

memory_store_id

string

Memory Store ID(memstore_ 前缀)

version_id

string

版本 ID(memver_ 前缀)

示例请求

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

示例响应

HTTP 200 OK — 未遮蔽版本

{
  "id": "memver_019e3bb9cf417d89970ba7f45e728c56",
  "type": "memory_version",
  "store_id": "memstore_019e3bb93b7074f9a5130d39ddcca90f",
  "entry_id": "mem_019e3bb9cf417d7dbb11fe9784dbb65c",
  "entry_path": "versions/test.md",
  "action": "created",
  "content": "Version 1 content",
  "size": 17,
  "content_sha256": "fe80a065cb120813abf7dfceb4018a53d6eb7140c785181634e019656176c64e",
  "redacted": false,
  "created_at": "2026-05-18T15:34:53.528628Z"
}

HTTP 200 OK — 已遮蔽版本

遮蔽后不再返回 content 字段:

{
  "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": true,
  "redacted_at": "2026-05-18T15:35:13.100297Z",
  "created_at": "2026-05-18T15:34:53.528628Z"
}

响应字段

字段

类型

说明

id

string

版本唯一标识符

type

string

固定值 "memory_version"

store_id

string

所属 Store ID

entry_id

string

关联的记忆条目 ID

entry_path

string

关联记忆条目的路径

action

string

操作类型:"created" / "updated" / "deleted"

content

string

版本内容(仅 redacted=false 时存在)

size

int64

内容大小(字节)

content_sha256

string

内容 SHA-256 哈希

redacted

boolean

是否已遮蔽

redacted_at

string

遮蔽时间(仅 redacted=true 时存在)

created_at

string

版本创建时间(ISO 8601)

错误码

HTTP

type

触发条件

401

authentication_error

未提供或无效的认证令牌

404

not_found_error

指定的 Memory Store 或版本不存在

注意事项

  • 获取单个版本详情时包含 content 字段(如果未被遮蔽)

  • 版本被 redact 后,content 字段不再出现在响应中

  • 被 redact 的版本会额外包含 redacted_at 时间戳

  • action: "deleted" 类型的版本不包含有意义的内容

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