跳转到主要内容

​
概览

筛选流端点组使开发者能够对公共 Post 的数据流进行过滤。该端点组包含多个端点，用于创建与管理规则，并将其应用于流，以仅返回与之匹配的公共 Post。借助该端点组，用户可以订阅特定主题与事件、监控比赛相关讨论、洞察趋势发展等。 开发者可以使用 REST 规则端点 来添加或移除规则，从而筛选出符合既定条件的 Post。这些规则可通过运算符匹配 Post 的属性，例如消息关键词、话题标签和 URL。可将运算符与规则子句用布尔逻辑与括号组合，以进一步精确匹配行为。 添加好一组规则后，你可以注册 webhook，X 将开始以 JSON 格式投递 Post objects。你的 webhook 只会接收与规则匹配的内容。 此端点支持已编辑的 Post。你的 webhook 将接收与一个或多个过滤条件匹配的已编辑 Post，以及其编辑历史记录，其中包含一个 Post ID 数组。对于没有编辑历史的 Post，此数组仅包含一个 ID；对于已编辑的 Post，此数组包含多个 ID，按升序排列以反映编辑顺序，数组最后一个元素为最新版本。要了解 Post 编辑的工作方式，请参阅Post 编辑基础页面。 注意：此端点组在规则设置方面与用于配置规则的 v2 筛选流端点类似。唯一的不同在于对匹配规则的 Post 的投递机制。
  • 对于 v2 筛选流端点，你需要建立持久连接并监听与规则匹配的 Post。
  • 对于本筛选流 webhook 端点，你注册 webhook，X 会将与规则匹配的 Post 投递到你的 webhook。
这无需再处理因客户端掉线或服务正常重启导致的断连问题。鉴于我们可能会以每秒数百个事件的速度进行投递，你的 webhook 服务器必须能够处理并发的连接尝试。 此端点目前向企业版开发者开放，并支持以下配置：
  • 每个项目 25,000+ 条规则
  • 构建规则时可使用所有运算符
  • 规则长度最多 2048 个字符
  • 申请企业版访问请点击此处
筛选流返回的 Post 将计入每月的 Post 上限。
账户设置要访问这些端点，你需要：在我们的入门指南中了解如何获取 X API v2 端点的访问权限。