# 获取推荐用户的接口

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

# 请求参数

参数名称 类型 是否必须 描述
limit int 数据数量
include string 关联数据

# include 可关联的数据

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

# 请求示例

# 返回说明

  • 成功,http 状态码: 200
  • 失败,http 状态码: 404

# 返回结果

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

参数名称 类型 出现要求 描述
data object 基础数据
type string 数据类型
id int 数据 id
attributes object 数据属性
id int 用户 id
username string 用户名
mobile string 手机号(脱敏)
avatarUrl string 头像地址
threadCount int 主题数
followCount int 关注数
fansCount int 粉丝数
likedCount int 主题点赞数
signature string 签名
usernameBout int 用户名修改次数
follow object 关注状态:
null 未登录/登陆用户与查询用户相同
0 未关注
1 已关注
2 互相关注
status int 状态
loginAt datetime 登录时间
joinedAt datetime 加入时间
expiredAt datetime 到期时间
createdAt datetime 创建时间
updatedAt datetime 修改时间
canEdit bool 是否可以编辑
canDelete bool 是否可以删除
canWalletPay bool 是否可以使用钱包支付
showGroups bool 是否显示群组
registerReason string 注册理由
banReason string 禁用理由
originalMobile string 完整手机号
registerIp string 注册 ip
lastLoginIp string 最后登录 ip
identity string 注册理由
realname string 实际姓名
walletBalance float 当前用户 用户余额
walletFreeze float 当前用户 用户冻结余额
paid bool 是否是付费用户
hasPassword bool 是否有密码(小程序注册用户无初始密码)
payTime datetime 支付时间
unreadNotifications int 未读消息数
typeUnreadNotifications array 未读消息数明细
typeUnreadNotifications.replied array 未读回复消息数
typeUnreadNotifications.liked array 未读点赞消息数
typeUnreadNotifications.rewarded array 未读打赏消息数
typeUnreadNotifications.system array 未读系统消息数
typeUnreadNotifications.related array 未读@通知消息数
typeUnreadNotifications.withdrawal array 未读提现通知消息数

# 返回示例

{
    "data": [
        {
            "type": "users",
            "id": "1",
            "attributes": {
                "id": 1,
                "username": "username",
                "avatarUrl": "avatarUrl",
                "isReal": true,
                "threadCount": 33,
                "followCount": 1,
                "fansCount": 1,
                "likedCount": 1,
                "signature": "1",
                "usernameBout": 1,
                "status": 0,
                "loginAt": "2020-08-21T14:49:29+08:00",
                "joinedAt": "2020-06-11T10:00:45+08:00",
                "expiredAt": "2020-07-27T15:34:54+08:00",
                "createdAt": "2020-06-11T10:00:46+08:00",
                "updatedAt": "2020-08-21T15:01:52+08:00",
                "canEdit": true,
                "canDelete": true,
                "showGroups": true,
                "registerReason": "",
                "banReason": "",
                "denyStatus": false,
                "originalMobile": "originalMobile",
                "registerIp": "registerIp",
                "registerPort": registerPort,
                "lastLoginIp": "lastLoginIp",
                "lastLoginPort": lastLoginPort,
                "identity": "1****************7",
                "realname": "realname",
                "mobile": "mobile",
                "hasPassword": true,
                "canEditUsername": true
            },
            "relationships": {
                "groups": {
                    "data": [
                        {
                            "type": "groups",
                            "id": "10"
                        }
                    ]
                }
            }
        }
    ],
    "included": [
        {
            "type": "groups",
            "id": "10",
            "attributes": {
                "name": "普通会员",
                "type": "",
                "color": "",
                "icon": "",
                "default": false,
                "isDisplay": false,
                "isPaid": false,
                "fee": 0,
                "days": 0,
                "scale": 0,
                "is_subordinate": false,
                "is_commission": false
            }
        }
    ]
}
最后更新: 9/14/2020, 5:01:47 PM