管理置顶列表

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

​

构建管理置顶 List 请求的步骤

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

在 Postman 中加载好 X API v2 集合后，导航到“List”文件夹，选择其中的“Pinned Lists”文件夹，然后选择“Pin a List”。  

步骤二：指定要置顶的 List

管理置顶 List 的端点需要两个 ID：一个是用户 ID（执行置顶操作的已认证用户），另一个是目标 List（要被置顶的 List）。用户 ID 必须与进行认证的用户 ID 一致，这意味着在为请求进行认证时，必须使用与该用户 ID 关联的 Access Tokens。在此情况下，你可以指定你自己的用户 ID。你可以通过以下两种方式找到你的 ID：

1. 使用按用户名查询的 users lookup 端点，传入用户名即可获得 id 字段。
2. 查看你的 Access Token，数字部分即为你的用户 ID。

目标 List ID 可以是任意有效的列表。在 Postman 中，转到“Params”选项卡，在 id 路径变量的“Value”列中输入用户 ID。转到“Body”选项卡，将你希望置顶的 List 的 ID 作为 list_id 参数的值。请确保在任何 ID 前后都不要包含空格。

Key	Value	Parameter type
id	用户 ID	path
list_id	要置顶的目标 List 的 ID	body

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

      https://api.x.com/2/users/2244994945/pinned_lists

第三步：发出请求并查看响应

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

{
  "data": {
    "pinned": true
  }
}

如果返回的响应对象中键 pinned 的值为 true，则表示您已成功将目标 List 置顶。

要取消置顶某个 List，请在 Postman 中加载的 X API v2 集合的“Lists”文件夹中选择“Unpin List”请求。此端点需要经过身份验证的用户 ID，以及要取消置顶的 List 的 ID。在“Params”选项卡中，将用户 ID 填入 id 列，并将要取消置顶的 List 的 ID 填入 list_id 列。

删除请求成功后，您将收到类似以下示例的响应：

{
  "data": {
    "pinned": false
  }
}