Introducción a los endpoints de cronologías de Posts de usuario y menciones
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: 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 encontrar 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 haces clic en el botón “Send” después del paso tres, recibirás en tu respuesta los campos predeterminados del objeto Post: id y text.
Si deseas recibir campos adicionales más allá de id y text, deberás especificarlos en tu solicitud con los parámetros fields y/o expansions.
Para este ejercicio, solicitaremos tres conjuntos adicionales y distintos de campos de diferentes 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 | |
https://api.x.com/2/users/:id/tweets?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.
"data": [
{
"author_id": "2244994945",
"created_at": "2020-09-03T17:31:39.000Z",
"id": "1301573587187331074",
"text": "Desde hoy, puedes ver tu uso mensual de Tweets de la API v2 en el portal de desarrolladores. ✨📊\n\nEsto muestra cuántos Tweets has recibido del stream filtrado y de la búsqueda reciente. Más información aquí: https://t.co/nfJHkFRQcZ https://t.co/vFXmoj3qaA"
},
{
"author_id": "2244994945",
"created_at": "2020-09-03T15:43:00.000Z",
"id": "1301546240887398401",
"text": "RT @snowman: Construimos una tabla de clasificación de golf en vivo con la X API usando Python, Flask, Postgres y Heroku.\n\nEnvía un Direct con \"leaderboard\"…"
},
{
"author_id": "2244994945",
"created_at": "2020-09-01T20:07:50.000Z",
"id": "1300888112948752389",
"text": "⛳ ¿Por qué los golfistas llevan una camisa extra? Por si hacen un hoyo en uno.\n\nAhora que tenemos tu atención, aprende cómo @snowman y @johnd crearon una tabla de clasificación de golf en tiempo real con la #TwitterAPI. 📖\n\nhttps://t.co/rRKeKmaRrN"
},
{
"author_id": "2244994945",
"created_at": "2020-08-28T23:14:22.000Z",
"id": "1299485505478963200",
"text": "RT @jessicagarson: Publiqué mi primer tutorial en @ThePracticalDev sobre cómo usar la v2 de la Twitter API. Aprenderás a explorar los Tweets de un usuario…"
},
{
"author_id": "2244994945",
"created_at": "2020-08-21T19:10:05.000Z",
"id": "1296887316556980230",
"text": "Descubre cómo @PennMedCDH está usando datos de Twitter para comprender la crisis sanitaria de COVID-19 📊\n\nhttps://t.co/1tdA8uDWes"
}
],
"includes": {
"users": [
{
"created_at": "2013-12-14T04:35:55.000Z",
"id": "2244994945",
"name": "Twitter Dev",
"username": "TwitterDev"
}
]
},
"meta": {
"newest_id": "1301573587187331074",
"next_token": "t3buvdr5pujq9g7bggsnf3ep2ha28",
"oldest_id": "1296887316556980230",
"previous_token": "t3equkmcd2zffvags2nkj0nhlrn78",
"result_count": 5
}
}
- 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 añadiremos 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 |
