Skip to content
API Library

会话列表

接口说明

Section titled “接口说明”

获取当前登录用户的所有会话，包括单聊和群聊，支持分页与按类型筛选。

请求信息

Section titled “请求信息”
项目 内容
方法 GET
URL https://devapi.fengshengshou.com/api/messages/conversations
鉴权 是，需在请求头携带 Token

请求参数

Section titled “请求参数”
参数名 类型 必填 说明
page int 否 页码，默认 1
per_page int 否 每页条数，默认 20
type string 否 会话类型，single（单聊）或 group（群聊），不传则返回全部

请求示例

Section titled “请求示例”
Terminal window
curl -X GET "https://devapi.fengshengshou.com/api/messages/conversations?page=1&per_page=20&type=group" \
  -H "Authorization: Bearer your_token_here"

响应参数

Section titled “响应参数”
字段 类型 说明
code int 状态码，0 表示成功
message string 提示信息
data.items array 会话列表
data.items[].id int 会话 ID
data.items[].type string 会话类型，single 或 group
data.items[].name string 会话显示名称
data.items[].avatar string|null 会话头像 URL，可为空
data.items[].is_group bool 是否为群聊
data.items[].member_count int|null 成员数量，仅群聊有值，可为空
data.items[].last_message string|null 最后一条消息内容，可为空
data.items[].last_sender_name string|null 最后发送者名称，群聊时有值，可为空
data.items[].time string 最后消息的格式化显示时间
data.items[].last_message_at string 最后消息时间，格式 Y-m-d H:i:s
data.items[].unread_count int 未读消息数量
data.items[].message_type string|null 最后消息类型，可为空
data.pagination object 分页信息
data.pagination.total int 总条数
data.pagination.per_page int 每页条数
data.pagination.current_page int 当前页码
data.pagination.last_page int 最后一页页码
data.pagination.has_more bool 是否有更多数据

成功响应

Section titled “成功响应”
{
  "code": 0,
  "message": "success",
  "data": {
    "items": [
      {
        "id": 101,
        "type": "group",
        "name": "研发团队",
        "avatar": "https://devapi.fengshengshou.com/storage/avatars/group1.png",
        "is_group": true,
        "member_count": 12,
        "last_message": "今天下午开会",
        "last_sender_name": "李四",
        "time": "14:30",
        "last_message_at": "2026-07-05 14:30:00",
        "unread_count": 3,
        "message_type": "text"
      },
      {
        "id": 55,
        "type": "single",
        "name": "王五",
        "avatar": null,
        "is_group": false,
        "member_count": null,
        "last_message": "好的，明白了",
        "last_sender_name": null,
        "time": "昨天",
        "last_message_at": "2026-07-04 18:10:00",
        "unread_count": 0,
        "message_type": "text"
      }
    ],
    "pagination": {
      "total": 25,
      "per_page": 20,
      "current_page": 1,
      "last_page": 2,
      "has_more": true
    }
  }
}

失败响应

Section titled “失败响应”
{
  "code": 401,
  "message": "未授权，请先登录",
  "data": null
}