获取会话历史消息

获取指定会话的历史消息记录,支持分页和游标查询.

查询参数:

会话标识:

conversation_id:会话ID,必填

分页方式:

cursor:游标方式分页,返回ID小于该值的历史消息

page_size:每页返回的消息数量,默认20,最大100

消息内容包含:

消息基本信息:

消息唯一ID

消息内容和类型

发送者信息(ID、昵称、头像)

发送时间和编辑状态

消息类型支持:

text:纯文本消息

image:图片消息

file:文件消息

voice:语音消息

video:视频消息

location:位置消息

link:链接消息

system:系统消息

消息状态:

sending:发送中

sent:已发送

delivered:已送达

read:已读

failed:发送失败

附加信息:

回复引用:回复某条消息时包含原消息信息

@提及:消息中@其他用户的信息

消息反应:点赞、表情等互动信息

编辑历史:消息编辑的时间和内容变化

查询特性:

游标分页:

使用消息ID作为游标,保证数据一致性

支持向前向后翻页

避免重复数据和遗漏数据

权限控制:

只能查看自己参与的会话消息

群聊消息对所有成员可见

系统消息对相关用户可见

性能优化:

消息缓存加速查询

分页预加载减少请求次数

压缩传输优化网络性能

历史保留:

普通消息保留时间:永久

系统消息保留时间:6个月

删除的消息在历史中隐藏但保留记录

实时同步:

支持WebSocket实时接收新消息

消息状态实时更新

离线消息自动同步

权限要求: 需要用户登录,且必须是会话参与者

OAuth 2.0

Password

Add the parameter

Authorization

to Headers，whose value is to concatenate the Token after the Bearer.

Example:

Authorization: Bearer ********************

Token URL: /api/v1/auth/login

获取会话历史消息

Request

Request Code Samples

Responses