跳转到主要内容
这三个时间线 endpoint 支持已编辑的 Post。这些 endpoint 将始终返回最新版本及其编辑历史。任何在 30 分钟编辑窗口结束后收集的 Post 都将表示其最终版本。编辑 metadata 包含其历史中所有 Post 的 id 数组。对于没有编辑历史的 Post，此数组仅包含一个 id。对于已编辑的 Post，此数组包含多个 id，按升序排列以反映编辑顺序，数组最后一个元素为最新版本。要了解 Post 编辑的工作方式，请参阅 Edit Posts 基础 页面。

​
逆时序首页时间线

此 endpoint 可用于检索已认证用户及其所关注账号最近发布的 Post、转发以及回复。 由于你是在代表某位用户发起请求，必须使用 OAuth 2.0 Authorization Code Flow with PKCE 或 OAuth 1.0a 用户上下文 对这些 endpoint 进行认证。此 endpoint 对每位用户的请求速率限制为每 15 分钟 180 次。此 endpoint 可返回时间线中过去 7 天内创建的所有 Post，以及不论创建日期的最近 800 条。

​
用户 Post 时间线

用户 Post 时间线 endpoint 提供对特定 X 账号已发布 Post 的访问。检索某个用户的 Post 可用于构建诸如在用户界面中展示时间线、分析用户的 Post 以更好地理解其内容，或以编程方式基于其 Post 创建互动工作流等体验。此 endpoint 可让你访问单个 X 账号的最新 Post、转发、回复和引用 Tweet，类似于用户个人资料时间线中所见的内容。 下面是 @XDevelopers 的用户时间线： 用户 Post 时间线 endpoint 是一个 REST endpoint，它接收一个路径参数以指示目标用户（通过 user ID）。该 endpoint 可以返回该用户最近的 3,200 条 Post、转发、回复和引用 Tweet。 Post 按时间逆序返回，从最新开始。结果分页，每页最多 100 条 Post。提供分页令牌以便在大量 Post 中逐页浏览。所给页面中包含的最新和最旧 Post 的 Post ID 也会作为 metadata 提供，并可用于轮询时间线以获取最新 Post。用户 Post 时间线还支持指定 start_time 和 end_time 参数，以接收在特定时间窗口内创建的 Post。  用户 Post 时间线 endpoint 支持 fields 和 expansions 参数，并返回新的 JSON 数据格式。 要成功向此 endpoint 发起请求，你需要使用 OAuth 1.0a 用户上下文、OAuth 2.0 授权码模式（Authorization Code）配合 PKCE 或 OAuth 2.0 App-Only 身份验证方法对请求进行授权。当请求非公开度量、推广度量或受保护用户的时间线时，必须使用 OAuth 1.0a 用户上下文或 OAuth 2.0 授权码模式（Authorization Code）配合 PKCE。  用户 Post 时间线 endpoint 旨在支持两种常见用法： 
  • “获取某用户的历史 Post”：向用户 Post 时间线发起请求，在特定的近期时间范围内按时间顺序接收目标用户创作的 Post。可使用 start_time 和 end_time 设置时间范围，并对完整结果进行分页。在某些情况下，如果该用户账号仅创作了不超过 3,200 条 Post，则可以检索其全部历史 Post。包含的 Post 将取决于其是否公开可用以及请求所使用的身份验证方式。
  • “轮询新 Post”：持续向用户 Post 时间线发起请求，以检索某个特定用户新创作的 Post。可将上次接收的 Post ID 作为参数，用于自上次 Post 以来的任何新请求。

​
用户提及时间线

“用户提及时间线” endpoint 允许你请求包含对特定 X 用户的提及的 Post，例如，当某个 X 账户在一条 Post 中提及了 @XDevelopers。返回结果也会包含对该用户 Post 的回复。检索某个用户的提及有助于你构建诸如快速发现谁在回复该用户的 Posts、谁在提及他们，或以编程方式为其 Posts 创建互动工作流等体验。该 endpoint 允许你请求单个用户的最新提及和回复，类似于在 X 上用户的提及通知中看到的内容。 “用户提及时间线”是一个 REST endpoint，它接收一个路径参数以指示目标用户（通过用户 ID）。该 endpoint 最多可返回该用户最近的 800 条提及。 Posts 按时间倒序返回，从最新开始。结果以每页最多 100 条 Post 的分页形式提供。系统会提供分页 token，以便遍历大型 Post 集合。该页中包含的最新和最旧 Posts 的 Post ID 也会作为 metadata 提供，可用于轮询时间线以获取最近的 Posts，或以类似 v1.1 mentions_timeline endpoint 的方式在时间线中导航。该 endpoint 还支持指定 start_time 和 end_time 参数，以获取在特定时间窗口内创建的 Posts。  要成功调用此 endpoint，你需要使用 OAuth 1.0a 用户上下文、OAuth 2.0 授权码模式（Authorization Code）配合 PKCE 或 OAuth 2.0 App-Only 方式为请求授权。当请求非公开度量、推广度量或受保护用户的时间线时，必须使用 OAuth 1.0a 用户上下文或 OAuth 2.0 授权码模式（Authorization Code）配合 PKCE。 “用户提及时间线” endpoint 支持 fields 和 expansions 参数，并返回新的 JSON data 格式。
账户设置要访问这些 endpoints，你需要：在我们的入门指南中了解如何获得 X API v2 endpoints 的访问权限。
支持资源 了解如何使用 Postman 发起请求 排查错误 访问此 endpoint 的 API 参考页面
⌘I