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

​
Pasos para crear una solicitud de consulta de Lists 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 List fijada de un usuario, debes especificar su ID de usuario en la solicitud. El ID de usuario debe corresponder al ID del usuario que autentica, lo que significa que debes pasar los Access Tokens asociados con ese ID de usuario al autenticar tu solicitud. En este ejemplo, puedes especificar el ID que pertenece a 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. Revisando 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.
KeyValue
id2244994945 (ID de usuario)
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 además 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 distintos objetos:
  • El campo adicional follower_count en el objeto List principal.
  • El user object completo usando el parámetro expansions.
  • El campo adicional tweet.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”:
KeyValueReturned fields
list.fieldsfollower_countfollower_count
expansionsowner_idincludes.users.id, <br/>includes.users.name, <br/>includes.users.username
user.fieldscreated_atincludes.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, presiona 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
  }
}
⌘I