Introducción a la cronología de inicio en orden inverso
Esta guía de inicio rápido le ayudará a realizar su primera solicitud a uno de los endpoints de cronologías con un conjunto de fields especificados usando Postman.
Si desea ver código de ejemplo en diferentes lenguajes, visite nuestro repositorio de GitHub X API v2 sample code.
Requisitos previosPara completar esta guía, necesitará un conjunto de keys and tokens para autenticar su solicitud. Puede generar estas keys and tokens siguiendo estos pasos:
Pasos para crear una solicitud de cronología de inicio en orden inverso
Para este ejemplo, haremos una solicitud al endpoint de cronología de Posts de usuario por ID, pero puede aplicar lo aprendido en este inicio rápido también a solicitudes de cronologías de menciones de usuario.
Paso uno: Comience con una herramienta o biblioteca
Existen varias herramientas, ejemplos de código y bibliotecas que puede usar para realizar una solicitud a este endpoint, pero aquí usaremos la herramienta Postman para simplificar el proceso.
Para cargar la colección de Postman de X API v2 en su entorno, haga clic en el siguiente botón:
Una vez que tenga la colección de X API v2 cargada en Postman, navegue a la carpeta “Timelines” y busque la solicitud “Reverse chronological home timeline”.
Paso dos: Autentique su solicitud
Para realizar correctamente una solicitud a la X API, debe verificar que tiene permiso. Para hacerlo con este endpoint, debe autenticar su solicitud con Código de autorización de OAuth 2.0 con PKCE o Contexto de usuario de OAuth 1.0a.
Debe agregar sus keys and tokens a Postman. Puede hacerlo seleccionando el entorno llamado “X API v2” en la esquina superior derecha de Postman y agregando sus keys and tokens en los campos “initial value” y “current value” (haciendo clic en el ícono de ojo junto al selector de entorno).
Estas variables se incorporarán automáticamente en la pestaña de autorización de la solicitud si lo ha hecho correctamente.
Paso tres: Identifique y especifique de qué usuario desea recuperar su cronología de inicio
Debe especificar un usuario para el cual desea recuperar Posts recientes dentro de la solicitud. En este ejemplo, pasaremos un único user ID.
Los user IDs son simplemente el valor numérico que representa el handle de una cuenta y que puede encontrar en la URL del perfil. Por ejemplo, el nombre de usuario de la siguiente cuenta es XDevelopers.
https://x.com/XDevelopers
Para convertir este nombre de usuario al user ID, deberá usar el users lookup endpoint con el nombre de usuario y obtener el user ID numérico en el payload. En el caso de @XDevelopers, el user ID es 2244994945.
En Postman, navegue a la pestaña “Params” e ingrese este user ID en la columna “Value” del parámetro id.
Paso cuatro: Identifique y especifique qué fields desea recuperar
Si hace clic en el botón “Send” después del paso tres, recibirá los fields predeterminados del Post object en su respuesta: id, text y edit_history_tweet_ids.
Si desea recibir fields adicionales, deberá especificarlos en su solicitud con los parámetros field y/o expansion.
Para este ejercicio, solicitaremos tres conjuntos adicionales de fields de distintos objetos:
-
El campo adicional tweet.created_at en los objetos de usuario principales.
-
Los campos predeterminados del objeto de usuario de los autores asociados para los Posts devueltos: id, name y username
-
El campo adicional user.created_at en los objetos de usuario asociados.
En Postman, ve a la pestaña “Params” y agrega el siguiente par clave:valor a la tabla “Query Params”:
| | |
|---|
| Key | Value | Returned fields |
tweet.fields | created_at | tweets.created_at |
expansions | author_id | includes.users.id, includes.users.name, includes.users.username |
user.fields | created_at | includes.users.created_at |
| max_results | 5 | |
Ahora deberías ver la siguiente URL junto al botón “Send”:
https://api.x.com/2/users/:id/timelines/reverse_chronological?tweet.fields=created_at&expansions=author_id&user.fields=created_at&max_results=5
Ten en cuenta:En Postman, el parámetro de ruta :id en el campo URL no se actualizará automáticamente con el valor que ingreses en el campo de params id, por lo que la URL anterior incluye :id y no 2244994945.
Paso cinco: Realiza tu solicitud y revisa tu respuesta
Una vez que tengas todo configurado, haz clic en el botón “Send” y recibirás la siguiente respuesta:
"data": [
{
"created_at": "2022-05-12T17:00:00.000Z",
"text": "Hoy se lanza Devs in the Details, una serie de videos técnicos hecha por y para desarrolladores que crean con la Twitter API. 🚀\n\nEn este episodio de estreno, @jessicagarson nos muestra cómo creó @FactualCat #WelcomeToOurTechTalk\n⬇️\n\nhttps://t.co/nGa8JTQVBJ",
"author_id": "2244994945",
"id": "1524796546306478083"
},
{
"created_at": "2022-05-11T19:16:40.000Z",
"text": "📢 Únete a @jessicagarson, @alanbenlee y @i_am_daniele mañana, 12 de mayo | 5:30 ET / 2:30 PT mientras conversan sobre el futuro de los bots https://t.co/sQ2bIO1fz6",
"author_id": "2244994945",
"id": "1524468552404668416"
},
{
"created_at": "2022-05-09T20:12:01.000Z",
"text": "¿Creas bots con la Twitter API? 🤖\n\nÚnete a @jessicagarson, @alanbenlee y @iamdaniele el jueves 12 de mayo | 5:30 ET / 2:30 PT mientras conversan sobre el futuro de los bots y responden a tus preguntas. 🎙📆⬇️\n\nhttps://t.co/2uVt7hCcdG",
"author_id": "2244994945",
"id": "1523757705436958720"
},
{
"created_at": "2022-05-06T18:19:54.000Z",
"text": "Si deseas postularte, o nominar a alguien más para el programa, siéntete libre de completar el siguiente formulario:\n\nhttps://t.co/LUuWj24HLu",
"author_id": "2244994945",
"id": "1522642324781633536"
},
{
"created_at": "2022-05-06T18:19:53.000Z",
"text": "Hemos detallado más a cada Insider en nuestra publicación del foro.\n\n¡Acompáñanos a felicitar a las nuevas incorporaciones! 🥳\n\nhttps://t.co/0r5maYEjPJ",
"author_id": "2244994945",
"id": "1522642323535847424"
}
],
"includes": {
"users": [
{
"created_at": "2013-12-14T04:35:55.000Z",
"name": "Twitter Dev",
"username": "TwitterDev",
"id": "2244994945"
}
]
},
"meta": {
"result_count": 5,
"newest_id": "1524796546306478083",
"oldest_id": "1522642323535847424",
"next_token": "7140dibdnow9c7btw421dyz6jism75z99gyxd8egarsc4"
}
}
Paso seis: pagina tus resultados
En la respuesta anterior, encontrarás al final un objeto meta que incluye los siguientes campos:
- oldest_id
- newest_id
- results_count
- next_token
- previous_token
En el paso cuatro, establecimos un valor de max_results de 5, lo que significa que cada página incluirá como máximo cinco resultados. Para acceder a las páginas adicionales de data, tomaremos el valor del campo next_token de nuestros últimos resultados y agregaremos esa cadena como valor del parámetro pagination_token en la página de params de Postman, manteniendo todo lo demás igual.
| |
|---|
| Key | Value |
pagination_token | t3buvdr5pujq9g7bggsnf3ep2ha28 |
Una vez que todo esté configurado, puedes hacer clic en “Send” nuevamente y deberías recibir la siguiente página de resultados.
Hemos preparado una guía sobre paginación para explicar este concepto con más detalle.
Próximos pasos
Personaliza tu solicitud usando la referencia de la API
Solicita ayuda a la comunidad