获取推荐用户的接口

• 接口说明： 获取指定数量推荐用户的接口，从登录时间在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
            }
        }
    ]
}