Gestionar miembros de la lista

​

Guía rápida para gestionar miembros de listas

Tenga en cuenta: Esta guía asume que ya completó los requisitos previos del resumen de inicio rápido.

​

Pasos para crear una solicitud para gestionar miembros de una Lista

​

Paso uno: Elige la colección del endpoint List en Postman

Una vez que tengas cargada la colección de X API v2 en Postman, ve a la carpeta “List”, selecciona la subcarpeta “List members” y luego elige “Add a member”.  

​

Paso dos: especifica el usuario que deseas agregar

Los endpoints para administrar miembros de una List requieren dos IDs: el ID de la List y el ID del usuario que se va a agregar. Puedes encontrar el ID del usuario usando la búsqueda de usuarios y pasando 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 o 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: realiza tu solicitud y revisa tu respuesta

Una vez que tengas todo configurado, 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 Lista.

Para eliminar a un miembro de una Lista, 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 Lista y el ID de usuario del miembro que deseas eliminar. En la pestaña “Params”, introduce el ID de la Lista como valor de la columna id y el ID del usuario que se va a eliminar como valor de la columna user_id.

Si la solicitud de eliminación se completa correctamente, recibirás una respuesta similar al siguiente ejemplo:

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