获取用户互动的用户列表

获取对 TA 操作标注的用户。

type=like 获得点赞了 uidOrUsername 的用户列表。

type=dislike 获得点踩了 uidOrUsername 的用户列表。

type=follow 获得关注了 uidOrUsername 的用户列表。

type=block 获得屏蔽了 uidOrUsername 的用户列表。

接口会根据配置表设置 运营 > 互动配置 > 查看互动记录设置 决定是否输出数据。

user_likers 配置，是否输出点赞 TA 的用户

user_dislikers 配置，是否输出点踩 TA 的用户

user_followers 配置，是否输出关注 TA 的用户

user_blockers 配置，是否输出屏蔽 TA 的用户

如果 uidOrUsername 为登录用户自己时，表示查看自己的数据，当上方配置为关闭时，则以此判断是否输出数据。

my_likers 配置，是否输出点赞我的用户

my_dislikers 配置，是否输出点踩我的用户

my_followers 配置，是否输出关注我的用户

my_blockers 配置，是否输出屏蔽我的用户

orderDirection 排序方向以创建时间排序。

请求参数

Path 参数

uidOrUsername

string

必需

用户 uid 或者 username

type

string

必需

查看类型 like,dislike,follow,block

Query 参数

orderDirection

string

可选

排序方向 asc,desc，默认 desc

whitelistKeys

string

可选

白名单键名，只返回给定键名的键值对
多个以英文逗号隔开，支持「点表示法」表示多维数组

blacklistKeys

string

可选

黑名单键名，从返回数据中删除指定的键值对
多个以英文逗号隔开，支持「点表示法」表示多维数组

pageSize

string

可选

每页显示条数（默认 15 条）

page

string

页码（默认 1）

可选

Header 参数

X-Fresns-App-Id

string

必需

密钥 App ID
密钥位置：控制面板->应用中心->应用密钥

默认值:

X-Fresns-Client-Platform-Id

integer

必需

平台编号，与密钥的「平台」匹配

默认值:

X-Fresns-Client-Version

string

必需

你的客户端版本号，推荐使用语义化版本号

默认值:

X-Fresns-Client-Device-Info

string

必需

交互设备信息 session_logs > device_info
压缩 Object 信息为字符串传参

默认值:

X-Fresns-Aid

string

可选

账号参数（留空则视为未登录账号）

默认值:

X-Fresns-Aid-Token

string

可选

账号身份凭证（传参 aid 时必传）

默认值:

X-Fresns-Uid

integer

可选

用户参数（留空则视为未登录用户）

默认值:

X-Fresns-Uid-Token

string

可选

用户身份凭证（传参 uid 时必传）

默认值:

X-Fresns-Signature

string

签名

必需

X-Fresns-Signature-Timestamp

string

必需

签名生成时间（当前 Unix 时间戳，精确到秒或毫秒都支持）

示例代码

Shell

JavaScript

Java

Swift

PHP

Python

HTTP

Objective-C

Ruby

OCaml

Dart

返回响应

🟢200成功

application/json

Body

code

integer

必需

message

string

必需

data

object

必需

paginate

object

必需

list

array[string]

必需

示例

{
  "code": 0,
  "message": "成功",
  "data": {
    "paginate": {
      "total": 0,
      "pageSize": 15,
      "currentPage": 1,
      "lastPage": 1
    },
    "list": []
  }
}