外观
获取历史消息
约 363 字大约 1 分钟
2025-05-28
1. 接口地址
{$host}/im/message/getHistory
2. 请求方式
GET
3. 请求参数
参数名 | 必填 | 类型 | 说明 |
---|---|---|---|
appKey | 是 | string | 应用Key,在开发者中心获取 |
timestamp | 是 | string | 当前请求时间戳,注意是秒级 |
signature | 是 | string | 签名,appSecret和timestamp拼接后MD5加密得到的字符串 |
groupId | 否 | string | 群ID,查询群历史消息时必填 |
userId1 | 否 | string | 用户1 ID,查询单聊历史消息时必填 |
userId2 | 否 | string | 用户2 ID,查询单聊历史消息时必填 |
limit | 否 | int | 每一页显示的数据,默认10条,最大为100 |
nextMessageId | 否 | Number | 下一次请求ID,首次为null或者不传递 |
4. 返回结果
字段 | 类型 | 说明 |
---|---|---|
list | Array | 消息列表数组,数组元素为消息对象,格式如下 |
nextMessageId | Number | 下一次请求的消息ID,如果没有更多消息,则为NULL |
4.1 群聊list元素
字段 | 类型 | 说明 |
---|---|---|
id | Number | 消息ID |
groupId | String | 群聊ID |
type | String | 消息类型,详见消息类型 |
senderId | String | 发送者ID |
content | String | 加密后的消息对象字符串 |
createTime | Number | 发布时间戳,单位:秒 |
4.2 单聊list元素
字段 | 类型 | 说明 |
---|---|---|
id | Number | 消息ID |
conversationId | String | 会话ID |
senderId | String | 发送者ID |
receiverId | String | 接收者ID |
type | String | 消息类型,详见消息类型 |
content | String | 消息对象字符串 |
createTime | Number | 发布时间戳,单位:秒 |