跳转到主要内容

​
概览

“过滤的流”endpoint 组使开发者能够筛选公开 Post 的实时 stream。该 endpoint 组包含多个 endpoint，可用于创建和管理规则，并将这些规则应用于 Posts 的流，以返回匹配的公开 Post。此 endpoint 组可帮助用户监听特定主题和事件、监控与竞赛相关的讨论、理解趋势的演变等。 开发者可以使用 REST rules endpoint 添加和删除规则，以筛选出符合预设条件的 Post。 这些 规则 可通过运算符创建，用于匹配 Post 的属性，例如消息关键词、话题标签和 URL。可以将运算符和规则子句与布尔逻辑及括号组合，以细化筛选器的匹配行为。  添加好一组规则后，你可以注册你的 webhook，X 将开始以 JSON 格式投递 Post 对象。你只会在 webhook 收到与规则匹配的内容。 此 endpoint 支持已编辑的 Post。你的 webhook 将接收匹配一个或多个筛选器的已编辑 Post，以及其编辑历史记录（包含一个 Post ID 数组）。对于没有编辑历史的 Post，该数组仅包含一个 ID。对于已编辑的 Post，该数组包含多个按升序排列的 ID，反映编辑顺序，数组最后一个元素为最新版本。要了解 Post 编辑机制，请参阅 Posts edits fundamentals 页面。  注意： 此 endpoint 组在规则设置方面与 v2 过滤的流 endpoint 类似。唯一的区别在于匹配规则的 Post 的投递机制不同。
  • 对于 v2 过滤的流 endpoint，你需要建立持久连接并监听与你的规则匹配的 Post。
  • 对于此过滤的流 webhook endpoint，你需要注册 webhook，X 会将与你的规则匹配的 Post 投递至你的 webhook。
这消除了因客户端掉线或我们服务正常重启导致的断连处理需求。由于我们可能每秒投递数百个事件，你的 webhook 服务器需要能够处理这些并发的连接尝试。 此 endpoint 目前面向 Enterprise 开发者开放，并支持以下配置：
  • 每个项目 25,000+ 条规则
  • 构建规则时可使用所有运算符
  • 规则长度最多 2048 个字符
  • 申请 Enterprise 访问请点击这里
从过滤的流返回的 Post 将计入每月的 Post 上限。
账户设置要访问这些 endpoint，你需要：在我们的 入门指南 中了解如何获取 X API v2 endpoint 的访问权限。
⌘I