Administrar listas ancladas

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

​

Pasos para crear una solicitud para administrar List fijadas

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 List que se va a fijar

Los endpoints para administrar List fijadas requieren dos ID: uno para el usuario (el usuario autenticado que fijará una List) y otro para la List de destino (la List que se fijará). El ID del usuario debe corresponder al ID del usuario autenticado, lo que significa que debes enviar los Access Tokens asociados con ese ID de usuario 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. Al revisar tu Access Token, verás que la parte numérica es tu ID de usuario.

El ID de la List de destino puede ser cualquier List válida. En Postman, navega a la pestaña “Params” e ingresa el ID de usuario en la columna “Value” de la variable de ruta id. Navega a la pestaña “Body” e indica el ID de la List 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 ID del usuario	path
list_id	El ID de la List de destino que se fijará	body

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

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

Paso tres: Realice su solicitud y revise su respuesta

Una vez que tenga todo configurado, haga clic en el botón «Send» y recibirá una respuesta similar al siguiente ejemplo:

{
  "data": {
    "pinned": true
  }
}

Has fijado correctamente la List de destino si el objeto de respuesta devuelto contiene el valor true para la clave pinned. 

Para desanclar una List, selecciona la solicitud “Unpin List”, que también se encuentra en la carpeta “Lists” de la colección X API v2 cargada en Postman. Este endpoint requiere el id del usuario autenticado y el id de la List que se va a desanclar. En la pestaña “Params”, ingresa el id del usuario como valor de la columna id y el id de la List que se va a desanclar como valor de la columna list_id. 

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

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