通知列表

  • 接口说明： 通知列表
  • 接口地址： /api/notification
  • 请求方式： GET

请求参数

参数名称类型是否必须描述示例
filter[type]string否通知类型
默认不传查全部
system 系统通知
replied 回复我的
liked 点赞我的
rewarded 支付我的
related @我的
withdrawal 提现通知		rewarded,withdrawal (逗号拼接,支持传多个)
page[number]int否页码
page[limit]int否单页数量

返回说明

  • 返回通知列表， http 状态码： 200

返回结果

字段名变量名必填类型描述
通知编号id是bigint消息 id
用户user_id是init用户 id
阅读时间read_at是string用户阅读时间
  1. // 回复我的、点赞我的通知 data 字段说明
  2. thread_id       主题 ID
  3. thread_title    标题（预留）
  4. post_id         帖子 ID
  5. post_content    帖子内容
  6. user_id         用户 ID
  7. user_name       用户名
  8. user_avatar     用户头像
  10. // 打赏我的通知 data 字段说明
  11. @zz

返回示例

字段描述注意
user_id发送人 ID
user_name发送人姓名
user_avatar发送人头像
read_at阅读时间
created_at点赞/回复/@的时间
thread_id通过哪个主题 ID 操作的
thread_title该主题标题
thread_created_at该主题创建时间
post_id点赞/回复/@的 ID
post_content点赞/回复/@的内容只有回复的通知这个字段不是空字符串,
空字符串前端做判断不展示白色部分的样式
post_created_at点赞/回复/@的时间
thread_username主题创建人
thread_user_groups主题创建人的用户组名
amount打赏金额
order_id订单 ID
reply_post_id楼中楼回复 ID如果不是 0 说明是楼中楼(点评)
reply_post_user_id楼中楼的用户ID只有在reply_post_id不为0时会有值
reply_post_content楼中楼的内容只有在reply_post_id不为0时会有值
reply_post_created_at楼中楼的创建时间只有在reply_post_id不为0时会有值
thread_is_approved主题是否合法是否合法（0/1/2）
0 不合法
1 正常
2 忽略
isReal是否已读
isScale是否分成收入如果是true财务通知的文案需要改一下 xx分成了我xx

注意：以下情况指的都是 回复、@、点赞通知消息

  1. 当回复的是主题详情页时，post_id 是主题评论id
  2. 当回复的是主题评论时，上面的 post_id 变成了该数据的 reply_post_id ，该数据的 post_id 是当前楼中楼的评论id

两个页面的纬度不一样，所以 post_id 会跟着变更

  • 点赞/回复/@通知 三个数据格式都一样:
  1. {
  2.   "data": [
  3.     {
  4.       "type": "notification",
  5.       "id": "44",
  6.       "attributes": {
  7.         "id": 44,
  8.         "type": "replied",
  9.         "user_id": 5,
  10.         "user_name": "username",
  11.         "user_avatar": "",
  12.         "read_at": "2020-04-21T18:54:53+08:00",
  13.         "created_at": "2020-04-21T18:52:38+08:00",
  14.         "thread_id": 3,
  15.         "thread_user_id": 1,
  16.         "thread_title": "测试点赞通知哈2哈哈",
  17.         "thread_created_at": "2020-04-17 14:22:07",
  18.         "post_id": 58,
  19.         "post_content": "回复你哈 回复人xuchen Configuration Dynamic Music",
  20.         "reply_post_id": 0,
  21.         "post_created_at": "2020-04-21 18:52:38",
  22.         "thread_username": "admin",
  23.         "isScale": true,
  24.         "isReal": false,
  25.       }
  26.     }
  27.   ]
  28. }
  • 支付通知示例:
字段描述注意
user_id发送人 ID
user_name发送人姓名
user_avatar发送人头像
read_at阅读时间
created_at通知时间
thread_id通过哪个主题 ID 操作的
order_type交易类型根据不同值展示文案不同: 1注册、2打赏、3付费主题
thread_title该主题标题当是普通帖时该值为空
thread_created_at该主题创建时间
content打赏的主题内容普通帖的内容，如果是主题帖就是标题内容
thread_username主题创建人
thread_user_groups主题创建人的用户组名
amount打赏金额
order_id订单 ID
reply_post_id楼中楼值一直等于0用于前端判断
  1. {
  2. "data": [
  3.       {
  4.           "type": "notification",
  5.           "id": "1697",
  6.           "attributes": {
  7.                 "id": 57,
  8.                 "type": "rewarded",
  9.                 "user_id": 4,
  10.                 "read_at": "2020-04-23T15:11:16+08:00",
  11.                 "created_at": "2020-04-23T15:11:04+08:00",
  12.                 "amount": 0.1,
  13.                 "content": "测试点赞通知",
  14.                 "order_id": 27,
  15.                 "order_type": 3,
  16.                 "thread_id": 3,
  17.                 "thread_title": "",
  18.                 "thread_created_at": "2020-04-17 14:22:07",
  19.                 "user_name": "username",
  20.                 "user_avatar": "http://discuz.com/storage/avatars/4.png?1587089944",
  21.                 "thread_username": "username",
  22.                 "thread_user_groups": "管理员",
  23.                 "reply_post_id": 0
  24.             }
  25.       }
  26.     ]
  27. }
  • 系统通知示例:
字段描述注意
user_id发送人 ID
user_name发送人姓名
user_avatar发送人头像
read_at阅读时间
created_at通知时间
title通知标题
content通知内容
raw.thread_id通过哪个主题 ID 操作的
raw.is_first是否是首贴
raw.tpl_id通知的模板 ID
  1. {
  2.   "data": [
  3.     {
  4.       "type": "notification",
  5.       "id": "14",
  6.       "attributes": {
  7.         "id": 14,
  8.         "type": "system",
  9.         "user_id": 1,
  10.         "user_name": "",
  11.         "user_avatar": "",
  12.         "read_at": "2020-04-23T15:11:46+08:00",
  13.         "created_at": "2020-04-20T10:42:48+08:00",
  14.         "title": "内容修改通知",
  15.         "content": "username你好，你发布的内容 \"测试点赞通知哈2@username\" 已被修改",
  16.         "raw": {
  17.           "id": 2,
  18.           "thread_id": 3,
  19.           "is_first": true,
  20.           "tpl_id": 9
  21.         }
  22.       }
  23.     }
  24.   ]
  25. }
  • 提现通知示例:
字段描述注意
id通知ID
user_id提现人ID
user_name提现人姓名
user_avatar提现人头像
cash_actual_amount实际提现金额
cash_apply_amount提现申请金额
cash_status提现状态1：待审核，2：审核通过，3：审核不通过，4：待打款， 5，已打款， 6：打款失败
remark拒绝原因
read_at阅读时间
created_at提现时间
  1. {
  2. "data": [
  3.         {
  4.             "type": "notification",
  5.             "id": "104",
  6.             "attributes": {
  7.                 "id": 104,
  8.                 "type": "withdrawal",
  9.                 "user_id": 4,
  10.                 "read_at": "2020-05-29T10:16:25+08:00",
  11.                 "created_at": "2020-05-28T08:18:58.000000Z",
  12.                 "wallet_cash_id": 35,
  13.                 "cash_actual_amount": "99.00",
  14.                 "cash_apply_amount": "100.00",
  15.                 "cash_status": 1,
  16.                 "remark": "",
  17.                 "user_name": "username",
  18.                 "user_avatar": "http://discuz.com/storage/avatars/4.png?1587089944",
  19.                 "thread_username": "",
  20.                 "thread_user_groups": ""
  21.             }
  22.         }
  23.     ],
  24. }