置顶 List 查询

请注意： 本指南假定你已完成快速上手概览中的前提条件。

​

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

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

在 Postman 中加载 X API v2 集合后，进入“List”文件夹，选择子文件夹“Pinned Lists”，然后选择“User’s pinned Lists”。

步骤二：确定并指定用户

要检索某个用户固定的 List，必须在请求中指定其用户 ID。该用户 ID 必须与进行身份验证的用户 ID 相同，这意味着在为请求进行身份验证时，必须传递与该用户 ID 关联的 Access Tokens。在此示例中，您可以指定自己账户的 ID。您可以通过两种方式找到您的 ID：

1. 使用按用户名的 users lookup endpoint，传入一个用户名以获取返回中的 id 字段。
2. 查看您的 Access Token，其中的数字部分即为您的用户 ID。

在 Postman 中，切换到“Params”选项卡，将该用户 ID 填入 id 参数的“Value”列。

Key	Value
id	2244994945（用户 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	返回的字段
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": "测试列表",
      "owner_id": "2244994945"
    }
  ],
  "includes": {
    "users": [
      {
        "username": "TwitterDev",
        "id": "2244994945",
        "created_at": "2013-12-14T04:35:55.000Z",
        "name": "Twitter Dev"
      }
    ]
  },
  "meta": {
    "result_count": 1
  }
}