主题
IM聊天室服务-获取会话消息记录 FunctionCode | SER-B006
简介
获取会话消息记录
接口说明
- 请求方式
POST
- Headers
Content-Type: application/json
- Headers
Authorization: Bearer ${access_token}
正式环境 | 测试环境 |
---|---|
https://linkingcloud.cn/#/contact-us | https://api.linkingopen.com/test/service/im/eplustoolim/api/conversation/messages |
请求参数
名称 | 描述 | 类型 | 必填 |
---|---|---|---|
conversationId | 会话Id | string | 是 |
userId | 用户Id | string | 是 |
userSig | 用户签名 | string | 是 |
minTime | 时间范围开始时间13位Unix时间戳(毫秒) | long | 是 |
maxTime | 时间范围结束时间13位Unix时间戳(毫秒)。 | long | 是 |
提示
无
返回参数
名称 | 描述 | 类型 | 必填 |
---|---|---|---|
code | 错误码(1标识成功) | int | 是 |
data | 返回数据。 | object | 是 |
message | 错误消息 | string | 否 |
返回参数
名称 | 描述 | 类型 | 必填 |
---|---|---|---|
convStartTime | 会话开始时间 | string | 是 |
messageList | 消息列表 | List<object> | 是 |
返回参数
名称 | 描述 | 类型 | 必填 |
---|---|---|---|
id | 消息id | string | 是 |
senderId | 发送者id | string | 是 |
content | 消息内容 | string | 是 |
type | 消息类型(文本=1, 图片=2,通知=99) | int | 是 |
status | 消息状态(已发送=1, 已读=2) | int | 是 |
createTimestamp | 创建时间戳 13位Unix时间戳(毫秒)。 | long | 是 |
接口示例
参数示例
json
{
"conversationId" : "123456",
"userId": "123",
"userSig": "123",
"minTime": 1738401287000,
"maxTime": 1740474799476
}
json
{
"code": 1,
"message": "操作成功",
"requestId": null,
"data": {
"convStartTime": "2025-02-25 17:13:19",
"messageList": [
{
"id": "865FBF60-4FB9-45EB-82DC-972FDD50C970",
"senderId": "123",
"content": "测试",
"type": 0,
"status": 1,
"createTimestamp": 0
},
{
"id": "8FE2E57F-4706-4EF9-B659-6313503D3F85",
"senderId": "456",
"content": "你好",
"type": 0,
"status": 1,
"createTimestamp": 0
}
]
},
"success": true
}