[会话]获取会话列表

  • 接口地址: /api/fresns/dialog/lists
  • 请求方式: POST
  • 请求格式: JSON

header 可选参数:

参数名公开模式(是否必传)私有模式(是否必传)
uidYESYES
midYESYES
tokenYESYES

body 参数:

参数名类型是否必传说明
pageSizeNumberNO每页显示条数(默认 30 条)
pageNumberNO页码(默认 1)

返回结果:

成功

{
    "code": 0,
    "message": "ok",
    "data": {
        "pagination": {
            "total": "一共有多少条数据",
            "current": "当前页码",
            "pageSize": "每页有多少条数据",
            "lastPage": "最后一页页码"
        },
        "list": [
            {
                "dialogId": "dialogs > id",
                "member": {
                    "deactivate": "members > deleted_at 布尔型(停用为 true),如果该成员已经停用,或者查不到数据(已删除),以下参数为空,头像除外",
                    "mid": "dialogs > a_member_id 或者 b_member_id",
                    "mname": "members > name",
                    "nickname": "members > nickname",
                    "avatar": "members > avatar_file_url,成员头像为空时 default_avatar 键值,已注销头像 deactivate_avatar 键值",
                    "decorate": "members > decorate_file_url",
                    "verifiedStatus": "members > verified_status",
                    "verifiedIcon": "members > verified_file_url",
                    "verifiedDesc": "members > verified_desc"
                },
                "messageId": "dialogs > latest_message_id",
                "messageTime": "dialogs > latest_message_time",
                "messageBrief": "dialogs > latest_message_brief",
                "messageUnread": "未读消息数量,实时计算。status 状态为“已读”状态时不计算消息未读数量",
                "status": "dialogs > a_status 或者 b_status",
            }
        ]
    }
}
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33

失败

{
    "code": "code_messages > code",
    "message": "code_messages > message"
}
1
2
3
4

开发说明

  • 确认身份,查询 a_member_idb_member_id 字段,确定身份为 A 或是 B 会话者。
  • 根据 latest_message_time 排序
  • 返回参数 messageTime 先根据传参时区(或默认时区)转换服务器时间和数据库字段时间,再做判断后输出。
    • 1、当前时间和服务器时间,属于同一天,输出「hh:mm」
    • 2、不是同一天,但是同一年,输出「mm-dd hh:mm」
    • 3、不是同一天,也不是同一年,输出「yyyy-mm-dd hh:mm」
  • 所有涉及图片的参数,需要判断是否开启了防盗链,如果开启了,不能直接使用 URL 字段值,需要获取防盗链链接。