分页获取聊天消息

分页获取历史聊天消息

HTTP请求

GET /api/v3/fiat/retrieveChatMessageWithPagination

接口权限要求: P2P 下单、P2P 广告主

请求参数

参数	类型	必传	说明
conversationId	integer	是	会话 ID
page	integer	是	页码，从 1 开始
limit	integer	是	每页条数，默认 20，最大 50
chatMessageType	string	否	消息类型过滤：`text`、`image`、`file`、`video`
id	integer	否	消息 ID（设置后查询单条消息详情）
sort	string	否	排序方式：`DESC`（默认）或 `ASC`

返回参数

参数	类型	说明
totalPage	integer	总页数
total	integer	总记录数
messages	array	消息列表
messages[].id	integer	消息 ID
messages[].conversationId	integer	会话 ID
messages[].content	string	文本消息内容
messages[].type	integer	消息类型：1=文字，2=图片，3=视频，4=文件
messages[].imageUrl	string	图片地址
messages[].imageThumbUrl	string	图片缩略图地址
messages[].videoUrl	string	视频地址
messages[].fileUrl	string	文件地址
messages[].createTime	string	发送时间
messages[].fromUserId	string	发送人 ID
messages[].fromNickName	string	发送人昵称
messages[].self	boolean	是否为自己发送

响应

{
  "msg": "success",
  "code": 0,
  "data": {
    "totalPage": 1,
    "total": 1,
    "messages": [
      {
        "id": 1,
        "conversationId": 50012,
        "content": "hello",
        "type": 1,
        "imageUrl": "",
        "imageThumbUrl": "",
        "videoUrl": "",
        "fileUrl": "",
        "createTime": "2025-01-26 12:00:00",
        "fromUserId": "abc123",
        "fromNickName": "商家A",
        "self": true
      }
    ]
  }
}