获取推荐用户的接口

  • 接口说明： 获取指定数量推荐用户的接口，从登录时间在30天内按照发布主题数量排序的用户中随即获取指定数量的数据，有1小时缓存
  • 接口地址： /api/users/recommended
  • 请求方式： GET

请求参数

参数名称类型是否必须描述
limitint否数据数量
includestring否关联数据

include 可关联的数据

关联名称模型类型是否默认描述
groupsgroupsobject是用户组

请求示例

返回说明

  • 成功，http 状态码： 200
  • 失败，http 状态码： 404

返回结果

关联数据模型字段释义参见请参见相应文档

参数名称类型出现要求描述
dataobject基础数据
typestring数据类型
idint数据 id
attributesobject数据属性
idint用户 id
usernamestring用户名
mobilestring手机号（脱敏）
avatarUrlstring头像地址
threadCountint主题数
followCountint关注数
fansCountint粉丝数
likedCountint主题点赞数
signaturestring签名
usernameBoutint用户名修改次数
followobject关注状态：
null 未登录/登陆用户与查询用户相同
0 未关注
1 已关注
2 互相关注
statusint状态
loginAtdatetime登录时间
joinedAtdatetime加入时间
expiredAtdatetime到期时间
createdAtdatetime创建时间
updatedAtdatetime修改时间
canEditbool是否可以编辑
canDeletebool是否可以删除
canWalletPaybool是否可以使用钱包支付
showGroupsbool是否显示群组
registerReasonstring注册理由
banReasonstring禁用理由
originalMobilestring完整手机号
registerIpstring注册 ip
lastLoginIpstring最后登录 ip
identitystring注册理由
realnamestring实际姓名
walletBalancefloat当前用户用户余额
walletFreezefloat当前用户用户冻结余额
paidbool是否是付费用户
hasPasswordbool是否有密码（小程序注册用户无初始密码）
payTimedatetime支付时间
unreadNotificationsint未读消息数
typeUnreadNotificationsarray未读消息数明细
typeUnreadNotifications.repliedarray未读回复消息数
typeUnreadNotifications.likedarray未读点赞消息数
typeUnreadNotifications.rewardedarray未读打赏消息数
typeUnreadNotifications.systemarray未读系统消息数
typeUnreadNotifications.relatedarray未读@通知消息数
typeUnreadNotifications.withdrawalarray未读提现通知消息数

返回示例

  1. {
  2.     "data": [
  3.         {
  4.             "type": "users",
  5.             "id": "1",
  6.             "attributes": {
  7.                 "id": 1,
  8.                 "username": "username",
  9.                 "avatarUrl": "avatarUrl",
  10.                 "isReal": true,
  11.                 "threadCount": 33,
  12.                 "followCount": 1,
  13.                 "fansCount": 1,
  14.                 "likedCount": 1,
  15.                 "signature": "1",
  16.                 "usernameBout": 1,
  17.                 "status": 0,
  18.                 "loginAt": "2020-08-21T14:49:29+08:00",
  19.                 "joinedAt": "2020-06-11T10:00:45+08:00",
  20.                 "expiredAt": "2020-07-27T15:34:54+08:00",
  21.                 "createdAt": "2020-06-11T10:00:46+08:00",
  22.                 "updatedAt": "2020-08-21T15:01:52+08:00",
  23.                 "canEdit": true,
  24.                 "canDelete": true,
  25.                 "showGroups": true,
  26.                 "registerReason": "",
  27.                 "banReason": "",
  28.                 "denyStatus": false,
  29.                 "originalMobile": "originalMobile",
  30.                 "registerIp": "registerIp",
  31.                 "registerPort": registerPort,
  32.                 "lastLoginIp": "lastLoginIp",
  33.                 "lastLoginPort": lastLoginPort,
  34.                 "identity": "1****************7",
  35.                 "realname": "realname",
  36.                 "mobile": "mobile",
  37.                 "hasPassword": true,
  38.                 "canEditUsername": true
  39.             },
  40.             "relationships": {
  41.                 "groups": {
  42.                     "data": [
  43.                         {
  44.                             "type": "groups",
  45.                             "id": "10"
  46.                         }
  47.                     ]
  48.                 }
  49.             }
  50.         }
  51.     ],
  52.     "included": [
  53.         {
  54.             "type": "groups",
  55.             "id": "10",
  56.             "attributes": {
  57.                 "name": "普通会员",
  58.                 "type": "",
  59.                 "color": "",
  60.                 "icon": "",
  61.                 "default": false,
  62.                 "isDisplay": false,
  63.                 "isPaid": false,
  64.                 "fee": 0,
  65.                 "days": 0,
  66.                 "scale": 0,
  67.                 "is_subordinate": false,
  68.                 "is_commission": false
  69.             }
  70.         }
  71.     ]
  72. }