置顶列表查询

请注意： 本指南以您已完成快速入门概述中的先决条件为前提。

​

构建固定 List 查询请求的步骤

步骤一：在 Postman 中选择 List 端点集合

将 X API v2 集合加载到 Postman 后，导航至“List”文件夹，选择其下的“Pinned Lists”文件夹，然后选择 “User’s pinned Lists”。  

步骤二：确认并指定用户

要检索某位用户固定的 List，必须在请求中指定其用户 ID。该用户 ID 必须与当前用于认证的用户 ID 一致，这意味着在对请求进行认证时，你必须传递与该用户 ID 关联的访问令牌（Access Tokens）。在此示例中，你可以填写你自己的用户 ID。你可以通过两种方式找到你的 ID：

1. 使用按用户名查询的 users lookup 端点，传入用户名即可返回包含 id 字段的结果。
2. 查看你的访问令牌（Access Token），其中的数字部分即为你的用户 ID。

在 Postman 中，前往 “Params” 选项卡，在 id 参数的 “Value” 列中输入该用户 ID。

Key	Value
id	2244994945 (user ID)

步骤三：确认并指定希望检索的字段

如果在完成步骤三后点击 “Send” 按钮，你将会在响应中收到默认的 List object 字段：id 和 name。

如果希望返回除 id 和 name 之外的更多字段，需要在请求中通过 field 和/或 expansion 参数进行指定。

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

• 主 List 对象中的附加字段 follower_count。
• 使用 expansion 参数请求完整的 user object。
• 关联的用户对象中的附加字段 tweet.created_at。

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

Key	Value	Returned fields
list.fields	follower_count	follower_count
expansions	owner_id	includes.users.id, <br/>includes.users.name, <br/>includes.users.username
user.fields	created_at	includes.users.created_at

现在你应该会在 “Send” 按钮旁看到一个类似的 URL：

https://api.x.com/2/users/2244994945/pinned_lists?expansions=owner_id&list.fields=follower_count&user.fields=created_at

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

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

{
  "data": [
    {
      "follower_count": 0,
      "id": "1454155907651158017",
      "name": "test 列表",
      "owner_id": "2244994945"
    }
  ],
  "includes": {
    "users": [
      {
        "username": "TwitterDev",
        "id": "2244994945",
        "created_at": "2013-12-14T04:35:55.000Z",
        "name": "Twitter 开发者"
      }
    ]
  },
  "meta": {
    "result_count": 1
  }
}