Skip to content

操作标记

  • 接口地址:/api/v2/user/mark
  • 请求方式:POST
  • 传参方式:application/json

Headers 可选参数

参数名公开模式(是否必传)私有模式(是否必传)
X-Fresns-AidYESYES
X-Fresns-Aid-TokenYESYES
X-Fresns-UidYESYES
X-Fresns-Uid-TokenYESYES

Body 参数

参数名类型是否必传说明
interactionTypeStringYES标记行为 like,dislike,follow,block
markTypeStringYES标记类型 user,group,hashtag,post,comment
fsidNumber / StringYES目标 FsID
user 传参 uid 或 username
group 传参 gid
hashtag 传参 hid
post 传参 pid
comment 传参 cid

接口使用说明

  • 标记的新建(创建)和取消(删除)使用同一个接口和同样参数,未标记时为新建,已标记时为取消。
  • 是否有权操作,配置入口 运营 > 互动配置 > 互动行为设置,配置值在对应内容接口 interaction 参数中。
  • 操作小组关注标记时,如果小组参数 followType = 2 时,不能通过该接口建立关注(由关联插件接管)。
  • likedislike 为互斥行为,如果已经 like 再操作 dislike 则将 like 取消并建立新的 dislike,反之亦然。
  • followblock 为互斥行为,如果已经 follow 再操作 block 则将 follow 取消并建立新的 block,反之亦然。
  • 无法对自己操作 followblock 标记。

返回结果

json
{
    "code": 0,
    "message": "ok",
    "data": null
}
开发说明
  • 用户关注专用:如果对方已经关注了我,则将我和他的 user_follows->is_mutual 字段值都改为 1,如果是取消关注,则修改为 0
  • 小组关注专用:
    • 接口 followType 参数来自 groups->type_follow 字段。
    • 判断 type_follow = 2 时,不能通过该接口建立关注。
  • type = like 或 follow 点赞和关注用户、帖子、评论,会给对方录入一条通知(数据表 notifications)。
  • 对同一个对象(点赞某人或关注某人),一天内只生产一次通知,避免频繁建立和取消的操作。

Released under the Apache-2.0 License