操作标记
- 接口地址:
/api/v2/user/mark
- 请求方式:
POST
- 传参方式:
application/json
Headers 可选参数
参数名 | 公开模式(是否必传) | 私有模式(是否必传) |
---|---|---|
X-Fresns-Aid | YES | YES |
X-Fresns-Aid-Token | YES | YES |
X-Fresns-Uid | YES | YES |
X-Fresns-Uid-Token | YES | YES |
Body 参数
参数名 | 类型 | 是否必传 | 说明 |
---|---|---|---|
interactionType | String | YES | 标记行为 like ,dislike ,follow ,block |
markType | String | YES | 标记类型 user ,group ,hashtag ,post ,comment |
fsid | Number / String | YES | 目标 FsID user 传参 uid 或 username group 传参 gid hashtag 传参 hid post 传参 pid comment 传参 cid |
接口使用说明
- 标记的新建(创建)和取消(删除)使用同一个接口和同样参数,未标记时为新建,已标记时为取消。
- 是否有权操作,配置入口
运营 > 互动配置 > 互动行为设置
,配置值在对应内容接口interaction
参数中。 - 操作小组关注标记时,如果小组参数
followType = 2
时,不能通过该接口建立关注(由关联插件接管)。 like
和dislike
为互斥行为,如果已经like
再操作dislike
则将like
取消并建立新的dislike
,反之亦然。follow
和block
为互斥行为,如果已经follow
再操作block
则将follow
取消并建立新的block
,反之亦然。- 无法对自己操作
follow
和block
标记。
返回结果
json
{
"code": 0,
"message": "ok",
"data": null
}
开发说明
- 用户关注专用:如果对方已经关注了我,则将我和他的
user_follows->is_mutual
字段值都改为 1,如果是取消关注,则修改为 0 - 小组关注专用:
- 接口
followType
参数来自groups->type_follow
字段。 - 判断
type_follow = 2
时,不能通过该接口建立关注。
- 接口
type = like 或 follow
点赞和关注用户、帖子、评论,会给对方录入一条通知(数据表 notifications)。- 对同一个对象(点赞某人或关注某人),一天内只生产一次通知,避免频繁建立和取消的操作。