管理转推

​

开始使用管理转发端点

本快速入门指南将帮助你使用 Postman 向管理转发端点发出首次请求。

如果你希望查看不同语言的示例代码，请访问我们的 X API v2 示例代码 GitHub 代码库。 

​

前置条件

要完成本指南，您需要一组用于对请求进行身份验证的密钥与令牌。您可以按照以下步骤生成这些密钥与令牌：

• 注册开发者账户并通过审批。
• 在开发者门户中创建一个Project及其关联的开发者 App。
• 前往您的 App 的“Keys and tokens”页面生成所需凭据。请务必将所有凭据保存在安全的位置。

​

构建管理转发请求的步骤

步骤一：从工具或库开始

有多种工具、代码示例和库可用于向此端点发起请求，但这里我们将使用 Postman 来简化流程。

要将 X API v2 的 Postman 集合加载到你的环境中，请点击以下按钮：

将 X API v2 添加到 Postman

在将 X API v2 集合加载到 Postman 后，前往“Retweets”文件夹，并选择“Retweet a Post”。  

步骤二：对你的请求进行身份验证

要正确向 X API 发起请求，你需要验证访问权限。对于此端点，你必须使用 OAuth 1.0a User Context 或 OAuth 2.0 授权码模式（含 PKCE）对请求进行身份验证。

在本示例中，我们将使用 OAuth 1.0a User Context。

你必须将你的密钥与令牌——具体包括 API Key、API Secret Key、OAuth 1.0a 用户 Access Token，以及 OAuth 1.0a 用户 Access Token Secret——添加到 Postman。你可以在 Postman 右上角选择名为“X API v2”的环境，并将你的密钥与令牌添加到“initial value”和“current value”字段中（点击环境下拉菜单旁的眼睛图标）。

如果设置正确，这些变量会自动填充到请求的“Authorization”选项卡中。

步骤三：指定你要转发的帖子

管理转发端点需要两个 ID：一个是希望转发或撤销转发的用户 ID，另一个是帖子的 id。

用户的 ID 必须与进行身份验证的用户 ID 相一致，这意味着在对请求进行身份验证时，你必须传递与该用户 ID 关联的访问令牌。在这种情况下，你可以指定你自己的用户 ID。你可以通过以下两种方式找到你的 ID：

1. 使用 user lookup by username 端点，传入用户名即可获得 id 字段。 
2. 查看你的 Access Token，其中的数字部分就是你的用户 ID。  

你还必须指定要转发的帖子。你可以通过访问 X.com，点击某个帖子，然后查看其 URL 来找到帖子 ID。例如，以下 URL 的帖子 ID 是 1228393702244134912。

https://x.com/TwitterDev/status/1228393702244134912

在 Postman 中，前往 “Params” 选项卡，将你的用户 ID 输入到路径变量 id 的 “Value” 列中，并将你希望转发的帖子的 ID 作为参数 tweet_id 的值输入。请确保任何 ID 前后都不要包含空格。

Key	Value
id	（你的用户 ID）
tweet_id	（你要转发的帖子的 ID）

点击 “Send” 按钮后，你将收到一个包含关系状态的响应对象：

• 如果返回 “retweeted”: true，则表示该 id 已成功转发 tweet_id。  

步骤四：发起请求并查看响应

完成所有设置后，点击 “Send” 按钮，你将收到如下响应：

{
    "data": {
        "retweeted": true
    }
}

如果你收到 "retweeted": true，则表示已成功转发该 tweet_id。

如果你希望撤销同一用户的转发，可以使用名为“撤销转发”的请求，它同样位于加载到 Postman 的 X API v2 集合中的“Retweets”文件夹内。id 应为你的用户 ID，source_tweet_id 应为要撤销转发的帖子 ID。你无需在 JSON 正文中添加它们，因此请确保在查询参数中加入 id 和 source_tweet_id。

成功撤销转发后，你将会收到与以下示例类似的响应：

{
  "data": {
    "retweeted": false
  }
}