管理置顶的 List

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

​

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

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

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

步骤二：指定要置顶的 List

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

1. 使用按用户名的 users lookup endpoint，传入用户名即可获得返回中的 id 字段。
2. 查看你的 Access Token，其中的数字部分就是你的用户 ID。

目标 List 的 ID 可以是任何有效的 List。在 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”请求。此 endpoint 需要经过认证的用户 ID，以及要取消固定的 List 的 ID。在“Params”选项卡中，将用户 ID 填入 id 列的值，并将要取消固定的 List 的 ID 填入 list_id 列的值。

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

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