转推查找

​

快速开始使用 Retweets 查询端点

本快速入门指南将帮助你使用 Postman 向 Retweets 查询端点发出你的第一个请求。若想查看不同语言的示例代码，请访问我们的 X API v2 sample code GitHub 代码库。

​

先决条件

要完成本指南，您需要一组用于对请求进行认证的keys 和 tokens。您可以按照以下步骤生成这些 keys 和 tokens：

• 注册开发者账号并通过审核。
• 在开发者门户中创建一个项目以及关联的开发者应用。
• 前往您的应用的“Keys and tokens”页面生成所需凭证。请务必将所有凭证妥善保管于安全位置。

​

构建 Retweets 查找请求的步骤

第一步：从某个工具或库入手

你可以使用多种工具、代码示例和库向此端点发起请求，但在本教程中我们将使用 Postman 来简化流程。

要将 X API v2 的 Postman 集合导入到您的环境中，请单击以下按钮：

在 Postman 中添加 X API v2

在 Postman 中加载 X API v2 集合后，前往“Retweets”文件夹并选择“Retweeted by”。

步骤二：对请求进行认证

要正确向 X API 发起请求，您需要先确认具备相应权限。为此，该端点要求您使用以下任一认证方式对请求进行认证：OAuth 2.0 App-Only、OAuth 2.0 授权码（PKCE） 或 OAuth 1.0a 用户上下文。

为简化说明，我们将在此请求中使用 OAuth 2.0 的 App-Only 模式；但如果你希望请求私有指标或转推（Retweets），则需要改用其他认证方法之一。

要使用 OAuth 2.0 App-Only，你需要将密钥和令牌添加到 Postman，尤其是应用访问令牌（也称为 App-only Bearer 令牌）。具体操作：在 Postman 右上角选择名为“X API v2”的环境，并将你的密钥和令牌填入“initial value”和“current value”字段（点击环境下拉菜单旁的眼睛图标进行查看/填写）。

如果你已按要求正确设置，这些变量会自动填入请求的“Authorization（授权）”选项卡。

步骤三：指定一个 Post

使用此端点时，必须指定要查询其转发用户的 Post 的 ID。你可以在 X 上打开该 Post，并从其 URL 末尾提取数值代码来找到该 Post 的 ID。比如，以下 URL 的 Post ID 为 1354143047324299264。

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

在 Postman 中，转到“Params”选项卡，将该用户名输入到本节底部 id 路径变量的“Value”列中，确保用户名左右没有空格。

关键	数值
id	要获取其转发用户的 Post ID

步骤四：确定并指定要获取的字段

在完成第 3 步后点击“Send”按钮，您的响应中将返回默认的 user object 字段：id、name、username。

如需获取除 id、name 和 username 之外的其他字段，必须在请求中通过 fields 和/或 expansions 参数指定这些字段。

在本练习中，我们将从不同的对象中请求三组额外的 fields：

1. 主要用户对象中的新增字段 user.created_at。
2. 返回用户的关联置顶 Post 对象的默认字段：id 和 text。
3. 关联的 Post 对象中新增的 tweet.created_at 字段。

在 Postman 中，转到“Params”选项卡，在“Query Params”表中添加以下键值对：

关键	价值	返回的字段
user.fields	created（已创建）_在	user.created_在
expansions	已置顶_Tweet_id	tweet.id, tweet.text
tweet.fields	已创建_在	tweet.created_在

现在你应当在“发送”按钮旁看到以下 URL：

https://api.x.com/2/tweets/1354143047324299264/retweeted_by?user.fields=created_at&expansions=pinned_tweet_id&tweet.fields=created_at

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

完成所有设置后，点击“Send”按钮，您将收到与下方示例响应类似的结果：

{
  "data": [
    {
      "created_at": "2008-12-04T18:51:57.000Z",
      "id": "17874544",
      "username": "TwitterSupport",
      "name": "Twitter 支持"
    },
    {
      "created_at": "2007-02-20T14:35:54.000Z",
      "id": "783214",
      "username": "Twitter",
      "name": "Twitter"
    },
    {
      "pinned_tweet_id": "1389270063807598594",
      "created_at": "2018-11-21T14:24:58.000Z",
      "id": "1065249714214457345",
      "username": "TwitterSpaces",
      "name": "Spaces"
    },
    {
      "pinned_tweet_id": "1293595870563381249",
      "created_at": "2007-05-23T06:01:13.000Z",
      "id": "6253282",
      "username": "XAPI",
      "name": "X API"
    }
  ],
  "includes": {
    "tweets": [
      {
        "created_at": "2021-05-03T17:26:09.000Z",
        "id": "1389270063807598594",
        "text": "现在，所有拥有 600 名及以上关注者的用户都可以主持 Space。\n\n根据我们的经验，这些账号因其既有受众，更有可能获得良好的主持体验。在向所有人开放创建 Space 之前，我们正专注于几件事。🧵"
      },
      {
        "created_at": "2020-08-12T17:11:04.000Z",
        "id": "1293595870563381249",
        "text": "X API v2：抢先体验上线\n\n今天我们宣布为新版 Twitter API 的首批端点提供抢先体验！\n\n#TwitterAPI #EarlyAccess #VersionBump https://t.co/g7v3aeIbtQ"
      }
    ]
  }
}