45 lines
1.9 KiB
Plaintext
45 lines
1.9 KiB
Plaintext
ET /v1/im/favorites/{favorite_id} 返回的是单条收藏详情，当前核心字段大概是这样：
|
|
{
|
|
"favorite_id": "fav_demo_19179719768_text",
|
|
"type": "text",
|
|
"snapshot": {
|
|
"topic": "favSeed19179719768",
|
|
"seq": 7001,
|
|
"from": "usr...",
|
|
"ts": "2026-08-25T07:26:06Z",
|
|
"type": "text",
|
|
"head": {},
|
|
"content": {},
|
|
"text": "这是一条收藏的文本消息"
|
|
},
|
|
"source": {
|
|
"topic": "favSeed19179719768",
|
|
"seq": 7001
|
|
},
|
|
"collected_at": "2026-08-25T07:26:06Z",
|
|
"availability": "available"
|
|
}
|
|
字段说明：
|
|
字段 含义
|
|
favorite_id 收藏记录 ID，后续详情、删除、转发都用它。
|
|
type 收藏类型：text、image、video、voice、file、link。
|
|
snapshot 收藏时保存的展示快照。即使原消息后续变化或删除，收藏列表也主要用这个字段渲染。
|
|
source.topic 原始消息所在会话 Topic。
|
|
source.seq 原始消息在该 Topic 下的消息序号。
|
|
collected_at 收藏时间，ISO/RFC3339 时间格式。
|
|
availability 当前可用状态，通常是 available；如果原资源被合规删除或失效，可能返回 removed 等状态。
|
|
|
|
|
|
snapshot 里面比较重要：
|
|
字段 含义
|
|
snapshot.topic 原消息 Topic。
|
|
snapshot.seq 原消息 seq。
|
|
snapshot.from 原消息发送人。
|
|
snapshot.ts 原消息发送时间。
|
|
snapshot.type 消息类型。通常和外层 type 一致。
|
|
snapshot.head 原消息头部扩展，比如 mime、x-im-type 等。
|
|
snapshot.content 原消息内容。文本、文件、图片、语音、链接等具体展示数据一般在这里。
|
|
snapshot.text 服务端提取出的纯文本摘要，方便列表搜索和预览展示。
|
|
|
|
|
|
前端一般列表页用外层 type + snapshot + collected_at + availability 渲染；点开详情时，如果是文件/图片/视频/语音，再根据 snapshot.content.file_id、thumbnail_file_id 等字段去走文件下载/预览逻辑。 |