Administrar miembros de la List

​

Guía rápida para administrar miembros de una List

Tenga en cuenta: Esta guía supone que ya completó los requisitos previos del resumen de la guía rápida.

​

Pasos para crear una solicitud de gestión de miembros de una List

​

Paso uno: Elija la colección de endpoints de List en Postman

Una vez que tenga cargada la colección de X API v2 en Postman, vaya a la carpeta “List”, seleccione la subcarpeta “List members” y luego elija “Add a member”.  

​

Paso dos: Especificar el usuario que se agregará

Los endpoints para gestionar miembros de una List requieren dos IDs: el ID de la List y el ID del usuario que se agregará. Puedes encontrar el ID del usuario usando users lookup y pasar un nombre de usuario para obtener el campo id.

El ID de destino puede ser cualquier ID de usuario válido. En Postman, ve a la pestaña “Params” e introduce tu ID en la columna “Value” de la variable de ruta id. Ve a la pestaña “Body” e introduce el ID del usuario que deseas agregar como valor del parámetro user_id. Asegúrate de no incluir espacios antes ni después de ningún ID.

Key	Value	Parameter type
id	El ID de la List	path
user_id	El ID del usuario de destino que deseas agregar como miembro	body

Ahora deberías ver una URL similar junto al botón “Send”:

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

Paso tres: Realizar la solicitud y revisar la respuesta

Una vez que hayas configurado todo, haz clic en el botón “Send” y recibirás una respuesta similar al siguiente ejemplo:

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

Si el objeto de respuesta devuelto contiene un valor true para la clave is_member, has agregado correctamente al usuario como miembro de la List. 

Para eliminar a un miembro de una List, selecciona la solicitud “Remove a member” que también se encuentra en la carpeta “Lists” de la colección de X API v2 cargada en Postman. Este endpoint requiere el ID de la List y el ID de usuario del miembro que deseas eliminar. En la pestaña “Params”, introduce el ID de la List como valor de la columna id y el ID del usuario que se eliminará como valor de la columna user_id. 

Si la solicitud DELETE se realiza correctamente, recibirás una respuesta similar al siguiente ejemplo:

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