Gestionar listas fijadas

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

​

Pasos para crear una solicitud para gestionar una Lista fijada

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

Una vez que tengas cargada la colección de X API v2 en Postman, navega a la carpeta “List”, selecciona la carpeta “Pinned Lists” y luego elige “Pin a List”.  

Paso dos: Especifica la Lista que deseas fijar

Los endpoints para gestionar Listas fijadas requieren dos ID: uno para el usuario (el usuario autenticado que fijará una Lista) y otro para la Lista de destino (la Lista que se va a fijar). El ID del usuario debe corresponder al ID del usuario que se autentica, lo que significa que debes pasar los Access Tokens asociados con el user ID al autenticar tu solicitud. En este caso, puedes especificar el ID que pertenece a tu usuario. Puedes encontrar tu ID de dos maneras:

1. Usando el endpoint users lookup por nombre de usuario, puedes pasar un nombre de usuario y recibir el campo id.
2. Revisando tu Access Token, verás que la parte numérica es tu user ID.

El ID de la Lista de destino puede ser cualquier lista válida. En Postman, navega a la pestaña “Params” e ingresa el user ID en la columna “Value” de la variable de ruta id. Navega a la pestaña “Body” e introduce el ID de la Lista que deseas fijar como valor del parámetro list_id. Asegúrate de no incluir espacios antes o después de ningún ID.

Key	Value	Parameter type
id	El user ID	path
list_id	El target List ID to be pinned	body

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

      https://api.x.com/2/users/2244994945/pinned_lists

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": {
    "pinned": true
  }
}

Has anclado correctamente la Lista objetivo si el objeto de respuesta devuelto contiene el valor true para la clave pinned. 

Para desanclar una Lista, selecciona la solicitud “Unpin List”, 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 del usuario autenticado y el id de la Lista que se va a desanclar. En la pestaña “Params”, introduce el id de usuario como valor de la columna id y el id de la Lista que se va a desanclar como valor de la columna list_id. 

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

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