[通知]获取消息列表

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

header 可选参数:

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

body 参数:

参数名类型是否必传说明
typeStringNO1.系统 / 2.关注 / 3.点赞 / 4.评论 / 5.提及(艾特) / 6.推荐
pageSizeNumberNO每页显示条数(默认 30 条)
pageNumberNO页码(默认 1)

返回结果:

成功

{
    "code": 0,
    "message": "ok",
    "data": {
        "pagination": {
            "total": "一共有多少条数据",
            "current": "当前页码",
            "pageSize": "每页有多少条数据",
            "lastPage": "最后一页页码"
        },
        "list": [
            {
                "notifyId": "notifies > id",
                "sourceType": "notifies > source_type",
                "sourceClass": "notifies > source_class",
                "sourceUuid": "notifies > source_id 转换成帖子或评论的 uuid",
                "sourceMember": {
                    "mid": "notifies > source_member_id 转换为 uuid",
                    "mname": "members > name",
                    "nickname": "members > nickname",
                    "avatar": "members > avatar_file_url",
                    "decorate": "members > decorate_file_url",
                    "verifiedStatus": "members > verified_status",
                    "verifiedIcon": "members > verified_file_url",
                    "verifiedDesc": "members > verified_desc"
                },
                "sourceBrief": "notifies > source_brief",
                "accessUrl": "notifies > access_url",
                "status": "notifies > status",
                "time": "notifies > created_at"
            }
        ]
    }
}
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
34

失败

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

开发说明

  • 按时间倒序排列
  • body 参数 type 留空代表输出全部,多个以英文逗号隔开。
  • 返回参数 time 先根据传参时区(或默认时区)转换服务器时间和数据库字段时间,再做判断后输出。
    • 1、当前时间和服务器时间,属于同一天,输出「hh:mm」
    • 2、不是同一天,但是同一年,输出「mm-dd hh:mm」
    • 3、不是同一天,也不是同一年,输出「yyyy-mm-dd hh:mm」
  • 所有涉及图片的参数,需要判断是否开启了防盗链,如果开启了,不能直接使用 URL 字段值,需要获取防盗链链接。