跳转到主要内容
本页介绍多种工具和关键概念，帮助你将 Posts 查询 endpoint 集成到你的系统中。我们将本页划分为以下几个部分：

​
实用工具

在我们深入介绍关键概念之前，建议先熟悉以下工具： Postman
Postman 是用于测试 endpoint 的优秀工具，涵盖各个路径和请求体参数，帮助你了解可用功能。查看我们的 Postman 入门指南了解更多。 代码示例
在我们的 GitHub 页面查找你偏好的编程语言的代码示例。 第三方库
使用社区构建、与 v2 endpoint 兼容的 第三方库。

​
核心概念

​
身份验证

所有 X API v2 endpoint 都需要经过身份验证的请求。你可以通过以下方式进行身份验证：
实现 OAuth 1.0a 可能具有一定难度。如果不熟悉，建议使用库或改用 OAuth 2.0 发起请求。对于私有度量或 Post，请使用 OAuth 1.0a 用户上下文或 OAuth 2.0 Authorization Code with PKCE。
请注意
如果你请求以下 fields，则需要 OAuth 1.0a 用户上下文或 OAuth 2.0 Authorization Code：
  • tweet.fields.non_public_metrics
  • tweet.fields.promoted_metrics
  • tweet.fields.organic_metrics
  • media.fields.non_public_metrics
  • media.fields.promoted_metrics
  • media.fields.organic_metrics

​
开发者门户、Project 和 App

要获取 X API v2 的凭据，您需要：
  1. 一个已获批准的开发者账户。
  2. 该开发者账户下的一个Project。
  3. 该 Project 下的一个开发者 App，其中可找到密钥和令牌。

​
请求速率限制

为管理请求量，X API 请求受请求速率限制。限制同时适用于 App 级和用户级：
  • App 级：限制任一 App 在每个时段内可发出的请求数。
  • 用户级：限制经身份验证的用户在各开发者 App 间执行 Post 查询的频率。

​
字段与扩展

X API v2 允许使用 fields 和 expansions 来选择特定的数据字段：
  • 扩展（expansions）：用于检索额外的相关对象。支持的扩展包括：
    • edit_history_tweet_ids
    • attachments.poll_ids
    • attachments.media_keys
    • author_id
    • entities.mentions.username
    • geo.place_id
    • in_reply_to_user_id
    • referenced_tweets.id
    • referenced_tweets.id.author_id
  • 字段（fields）：在对象中指定要返回的数据字段，以获取更多数据。Post 对象默认仅包含 id、text 和 edit_history_tweet_ids。其他选项（例如 tweet.created_at 和 tweet.entities）需要显式请求。
更多信息请参见 X API v2 数据字典中的“字段与扩展”指南。

​
Post 编辑

符合条件的 Post 可在发布后 30 分钟内最多编辑五次。Posts 查询 endpoint 始终返回最新的 Post 版本。针对近实时场景，请留意该时间窗口。更多详情参见 Edit Posts 基础知识。

​
边缘情况

  • 推广度量（promoted metrics）：为非推广的 Post 请求推广度量会返回空响应。
  • 文本截断：在转发中，Post 文本会被截断。要获取完整文本，请展开被引用的 Post
⌘I