fresns

操作标记

开发中

POST

/api/v2/user/mark

标记的新建（创建）和取消（删除）使用同一个接口和同样参数，未标记时为新建，已标记时为取消。

是否有权操作，配置入口 运营 > 互动配置 > 互动行为设置，配置值在对应内容接口 interaction 参数中。

操作小组关注标记时，如果小组参数 followType = 2 时，不能通过该接口建立关注（由关联插件接管）。

like 和 dislike 为互斥行为，如果已经 like 再操作 dislike 则将 like 取消并建立新的 dislike，反之亦然。

follow 和 block 为互斥行为，如果已经 follow 再操作 block 则将 follow 取消并建立新的 block，反之亦然。

无法对自己操作 follow 和 block 标记。

请求参数

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 时间戳，精确到秒或毫秒都支持）

Body 参数application/json

interactionType

string

必需

标记行为 like,dislike,follow,block

markType

string

必需

标记类型 user,group,hashtag,post,comment

fsid

string

必需

目标 FsID
user 传参 uid 或 username
group 传参 gid
hashtag 传参 hid
post 传参 pid
comment 传参 cid

示例

{
  "interactionType": "string",
  "markType": "string",
  "fsid": "string"
}

示例代码

Shell

JavaScript

Java

Swift

PHP

Python

HTTP

Objective-C

Ruby

OCaml

Dart

curl --location --request POST 'http://localhost:8080/api/v2/user/mark' \
--header 'X-Fresns-App-Id;' \
--header 'X-Fresns-Client-Platform-Id;' \
--header 'X-Fresns-Client-Version;' \
--header 'X-Fresns-Client-Device-Info;' \
--header 'X-Fresns-Aid: ' \
--header 'X-Fresns-Aid-Token: ' \
--header 'X-Fresns-Uid: ' \
--header 'X-Fresns-Uid-Token: ' \
--header 'X-Fresns-Signature;' \
--header 'X-Fresns-Signature-Timestamp;' \
--header 'Content-Type: application/json' \
--data-raw '{
    "interactionType": "string",
    "markType": "string",
    "fsid": "string"
}'

返回响应

🟢200成功

application/json

Body

object {0}

示例

{}

修改于 2023-03-28 07:32:48

修改用户资料