获取用户[详情] 互动列表
- 接口地址:
/api/v2/user/{uidOrUsername}/interaction/{type} - 请求方式:
GET - 传参方式:
Rest+Query
Headers 可选参数
| 参数名 | 公开模式(是否必传) | 私有模式(是否必传) |
|---|---|---|
| X-Fresns-Aid | NO | YES |
| X-Fresns-Aid-Token | NO | YES |
| X-Fresns-Uid | NO | YES |
| X-Fresns-Uid-Token | NO | YES |
Rest 参数
| 参数名 | 类型 | 是否必传 | 说明 |
|---|---|---|---|
| uidOrUsername | Number / String | YES | 用户 uid 或者 username |
| type | String | YES | 查看类型 likers,dislikers,followers,blockers |
Query 参数
| 参数名 | 类型 | 是否必传 | 说明 |
|---|---|---|---|
| orderDirection | String | NO | 排序方向 asc,desc,默认 desc |
| whitelistKeys | String | NO | 白名单键名,只返回给定键名的键值对 多个以英文逗号隔开,支持「点表示法」表示多维数组 |
| blacklistKeys | String | NO | 黑名单键名,从返回数据中删除指定的键值对 多个以英文逗号隔开,支持「点表示法」表示多维数组 |
| pageSize | Number | NO | 每页显示条数(默认 15 条) |
| page | Number | NO | 页码(默认 1) |
接口使用说明
type=likers获得点赞了uidOrUsername的用户列表。type=dislikers获得点踩了uidOrUsername的用户列表。type=followers获得关注了uidOrUsername的用户列表。type=blockers获得屏蔽了uidOrUsername的用户列表。- 接口会根据配置表设置
运营 > 互动配置 > 查看互动记录设置决定是否输出数据。user_likers配置,是否输出点赞他的用户user_dislikers配置,是否输出点踩他的用户user_followers配置,是否输出关注他的用户user_blockers配置,是否输出屏蔽他的用户
- 如果
uidOrUsername为登录用户自己时,表示查看自己的数据,当上方配置为关闭时,则以此判断是否输出数据。my_likers配置,是否输出点赞我的用户my_dislikers配置,是否输出点踩我的用户my_followers配置,是否输出关注我的用户my_blockers配置,是否输出屏蔽我的用户
orderDirection排序方向以创建时间排序。
返回结果
json
{
"code": 0,
"message": "ok",
"data": {
"pagination": {
"total": "Number / 一共有多少条数据",
"pageSize": "Number / 每页有多少条数据",
"currentPage": "Number / 当前页码",
"lastPage": "Number / 最后一页页码"
},
"list": [
{
// 通用数据结构->用户信息
}
]
}
}