选择事件类型

默认情况下,你监控的每个账号的所有事件类型都会送达。你可以按账号缩小范围:一个账号只给你推送新增蓝V粉丝,另一个账号把它发的所有内容都推给你。这个选择属于订阅本身,所以每个账号单独设置、互不影响。

可以选择的事件类型

下面每一种事件类型都可以针对每个账号单独打开或关闭。关键词命中(search.match)不在这张表里:它来自关键词,而不是来自某个账号。

类型类别含义
tweet.create帖子该账号发布了新内容
tweet.reply帖子它回复了某人;reply_to 携带被回复的帖子,含文本和媒体
tweet.retweet帖子它转推了某人;retweet_of 携带完整的原帖
tweet.quote帖子它引用了某人;quoted 携带完整的被引用帖子
tweet.edit帖子它编辑了一条帖子;事件携带新版本,edit_of 是被它替换的版本
tweet.delete帖子该账号发布过的一条帖子消失了
profile.name资料显示名称已更改
profile.screen_name资料用户名已更改
profile.bio资料简介已更改
profile.location资料位置已更改
profile.url资料资料链接已更改
profile.avatar资料头像已更改;old 和 new 为图片 URL
profile.banner资料横幅已更改;old 和 new 为图片 URL
profile.pinned资料置顶帖子已更改;tweet 和 old_tweet 携带帖子本身
profile.verified资料认证标识出现或消失
follow.add关注关系该账号开始关注某人;user 是对方的完整资料
follow.remove关注关系该账号取消关注了某人
followers.verified.add关注关系一个认证账号开始关注它;user 携带简介、计数、位置、注册日期
account.status账号账号变为受保护、被封禁或不可见,或恢复正常

常见组合

把右侧一栏的值作为 event_types 发送即可。类型可以随意组合,需要几种就列几种。

你想要event_types
只要这个账号新增的蓝V粉丝["followers.verified.add"]
只要它的原创帖子["tweet.create"]
只要它的回复["tweet.reply"]
它发布的一切:原创、回复、转推、引用和编辑["tweet.create", … 5 种]
它的原创,以及它删帖的通知["tweet.create", "tweet.delete"]
只要资料变更(全部 9 种资料类型)["profile.name", … 9 种]
只要它关注了谁、取关了谁["follow.add", "follow.remove"]
全部(默认)null

如何设置

可以在开始监控账号时就选好,也可以之后随时修改。两个调用都需要 targets:write 权限。

开始监控时就指定
curl -X POST https://api.xsignalfeed.com/v1/monitor/targets \
  -H "Authorization: Bearer xsf_your_key" -H "Content-Type: application/json" \
  -d '{"screen_name": "elonmusk", "event_types": ["followers.verified.add"]}'
之后修改
curl -X PATCH https://api.xsignalfeed.com/v1/monitor/targets/elonmusk \
  -H "Authorization: Bearer xsf_your_key" -H "Content-Type: application/json" \
  -d '{"event_types": ["tweet.create", "tweet.reply"]}'
恢复为全部类型
curl -X PATCH https://api.xsignalfeed.com/v1/monitor/targets/elonmusk \
  -H "Authorization: Bearer xsf_your_key" -H "Content-Type: application/json" \
  -d '{"event_types": null}'

账号当前的选择在它的 event_types 字段里;没有任何过滤时 event_types_all 为 true。

GET /v1/monitor/targets/elonmusk
{
  "target": {
    "id": "44196397",
    "screen_name": "elonmusk",
    "name": "Elon Musk",
    "state": "subscribed",
    "…": "…",
    "event_types": [
      "tweet.create",
      "tweet.reply"
    ],
    "event_types_all": false
  }
}

规则

不能选择的内容