列表成员管理

​

管理 List 成员快速入门指南

请注意： 本指南假设你已完成快速入门总览中的前提条件。

​

构建管理列表成员请求的步骤

​

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

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

​

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

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

目标 ID 可以是任何有效的用户 ID。在 Postman 中，转到“Params”选项卡，将你的 ID 输入到 id 路径变量的“Value”列中。然后转到“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”请求。此端点需要该 List 的 ID 和要移除成员的用户 ID。在“Params”选项卡中，将该 List 的 ID 填入 id 列，将要移除的用户 ID 填入 user_id 列。

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

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