管理 List 成员

​

管理 List 成员快速上手指南

请注意： 本指南假定您已完成快速上手概览中的先决条件。

​

构建管理 List 成员请求的步骤

​

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

在 Postman 中加载 X API v2 集合后，依次进入“List”文件夹中的“List members”子文件夹，然后选择“Add a member”。  

​

步骤二：指定要添加的用户

管理 List 成员的 endpoint 需要两个 ID：List 的 ID 和要添加的用户的 ID。你可以使用 users lookup 查找用户的 ID，并传入用户名以获取 id 字段。

目标 ID 可以是任意有效的用户 ID。在 Postman 中，转到 “Params” 选项卡，在 id 路径变量的 “Value” 列中输入你的 ID。然后转到 “Body” 选项卡，将你希望添加的用户的 ID 作为 user_id 参数的值。请务必不要在任何 ID 的前后包含空格。

Key	Value	Parameter type
id	List ID	path
user_id	你希望添加为成员的目标用户 ID	body

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

https://api.x.com/2/lists/1441162269824405510/members

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

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

{
  "data": {
    "is_member": true
  }
}

如果返回的响应对象中键 is_member 的值为 true，则表示已成功将该用户添加为该 List 的成员。

要从 List 中移除成员，请在已加载到 Postman 的 X API v2 集合的“Lists”文件夹中选择“Remove a member”请求。该 endpoint 需要该 List 的 ID 以及你希望移除的成员的用户 ID。在“Params”选项卡中，将该 List 的 ID 填入 id 列，将要移除的用户的 ID 填入 user_id 列。

在成功的 delete 请求后，你将收到与以下示例类似的响应：

{
  "data": {
    "is_member": false
  }
}