Consulta de lista fijada

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

​

Pasos para crear una solicitud de consulta de Listas fijadas

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

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

Paso dos: Identifica y especifica al usuario

Para recuperar la Lista fijada de un usuario, debes especificar su ID de usuario en la solicitud. El ID de usuario debe corresponder al ID del usuario autenticado, lo que significa que debes pasar los Access Tokens asociados con ese ID al autenticar tu solicitud. En este ejemplo, puedes especificar el ID de tu propio 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. En tu Access Token, verás que la parte numérica es tu ID de usuario.

En Postman, navega a la pestaña “Params” e ingresa este ID de usuario en la columna “Value” del parámetro id.

Key	Value
id	2244994945 (user ID)

Paso tres: Identifica y especifica qué campos deseas recuperar

Si haces clic en el botón “Send” después del paso tres, recibirás en tu respuesta los campos predeterminados del List object: id y name.

Si deseas recibir campos adicionales más allá de id y name, tendrás que especificarlos en tu solicitud con los parámetros fields y/o expansions.

Para este ejercicio, solicitaremos tres conjuntos adicionales de campos de diferentes objetos:

• El campo adicional follower_count en el objeto principal List.
• El user object completo usando el parámetro expansions.
• El campo adicional created_at en el objeto de usuario asociado.

En Postman, navega a la pestaña “Params” y agrega el siguiente par clave:valor a la tabla “Query Params”:

Key	Value	Returned fields
list.fields	follower_count	follower_count
expansions	owner_id	includes.users.id, <br/>includes.users.name, <br/>includes.users.username
user.fields	created_at	includes.users.created_at

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

https://api.x.com/2/users/2244994945/pinned_lists?expansions=owner_id&list.fields=follower_count&user.fields=created_at

Paso cuatro: 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": [
    {
      "follower_count": 0,
      "id": "1454155907651158017",
      "name": "lista de prueba",
      "owner_id": "2244994945"
    }
  ],
  "includes": {
    "users": [
      {
        "username": "TwitterDev",
        "id": "2244994945",
        "created_at": "2013-12-14T04:35:55.000Z",
        "name": "Twitter Dev"
      }
    ]
  },
  "meta": {
    "result_count": 1
  }
}