跳转到主要内容本页介绍在将 Retweet 端点集成到你的系统时需要了解的多种工具和关键概念。我们将内容分为以下几个部分：
在深入介绍有助于你集成此端点的一些关键概念之前，建议先熟悉以下内容：
Postman 是一款非常实用的工具，可用于测试各个 endpoint。每个 Postman 请求都包含所有路径参数和请求体参数，帮助你快速了解可用项。要了解我们的 Postman 集合的更多信息，请访问我们的 “使用 Postman” 页面。
想用你常用的编程语言，通过代码快速接入此 endpoint 吗？我们在 GitHub 页面 提供了多种代码示例，可作为你的起点。
利用我们社区维护的第三方库来快速上手。查看相应的版本标签即可找到兼容 v2 端点的库。
所有 X API v2 端点都要求你使用一组凭证（也称为密钥和令牌）对请求进行认证。
你可以使用 OAuth 1.0a 用户上下文或 OAuth 2.0 Bearer Token 来对发往 Retweets 查找端点的请求进行认证。
管理 Retweets 的端点必须使用 OAuth 1.0a 用户上下文，这意味着你需要使用一组 API 密钥和用户访问令牌才能成功发起请求。访问令牌必须与你所代表的用户相关联。如果你希望为其他用户生成一组访问令牌，他们必须通过 3-legged OAuth 流程对你的应用进行授权或认证。
请注意，OAuth 1.0a 使用起来可能较为复杂。如果你不熟悉这种认证方法，建议使用库来正确完成请求认证。
请注意
如果你请求以下 fields，则必须使用 OAuth 1.0a 用户上下文：
- 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
要获取可用于 X API v2 端点的一组认证凭据，您需要先注册开发者账户，在该账户下设置一个项目，并在该项目中创建一个开发者应用。随后，您可以在开发者应用中找到密钥和令牌。
每天都有成千上万的开发者向 X API 发起请求。为管理庞大的请求量，速率限制 会施加到每个 endpoint，用以限制你代表你的应用或已认证用户所能发起的请求次数。
管理 Retweets 的 endpoints：每位用户每 15 分钟最多 50 次请求。此外，对于 POST endpoint，每位用户、每个应用在每 3 小时窗口内最多 300 次请求。
对于 Retweets 查询 endpoint：每个 15 分钟窗口最多 75 次请求。此外，该 endpoint 仅返回最近的 100 位进行 Retweet 的用户。
X API v2 提供一组称为字段与 expansions 的工具，允许用户精确选择希望从 API 返回的 data。expansions 参数允许你展开负载中被引用的对象。例如，此端点允许你获取以下 expansions：
- 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 参数允许你选择不同 data 对象中希望接收的具体 fields。这些端点主要返回 Post 对象。默认情况下，Post 对象返回 id 和 text 字段。若需接收其他字段（如 tweet.created_at 或 tweet.entities），需要通过 fields 参数显式请求。在你的集成中，一些你可能会考虑使用的重要字段包括投票数据、指标、Post 注释，以及会话 ID 字段。
我们在 X API v2 data dictionary 中新增了关于如何同时使用 fields 和 expansions的指南。 
