List Posts lookup: Standard v1.1 comparado con X API v2
Si has estado trabajando con el endpoint estándar v1.1 GET lists/statuses, el objetivo de esta guía es ayudarte a entender las similitudes y diferencias entre los endpoints estándar v1.1 y de X API v2.- Similitudes
- Métodos de autenticación
- Rate limits
- Diferencias
- URLs de endpoints
- Requisitos de App y Project
- Límites de objetos de datos por solicitud
- Formatos de datos de respuesta
- Parámetros de solicitud
Similitudes
Autenticación Ambas versiones del endpoint admiten OAuth 1.0a User Context. Por lo tanto, si anteriormente usabas uno de los endpoints estándar v1.1 de List Posts lookup, puedes seguir utilizando el mismo método de autenticación si migras a la versión de X API v2. Dependiendo de tu biblioteca/paquete de autenticación preferido, la autenticación App only probablemente sea la forma más sencilla de empezar y se puede establecer con un encabezado de solicitud simple. Para aprender cómo generar un Access Token App only, consulta esta guía de App only. Rate limitsDiferencias
URLs de endpoints- Endpoints estándar v1.1:
- GET https://api.x.com/1.1/lists/statuses.json (Consulta los Tweets de una List especificada)
- Endpoint X API v2:
- GET https://api.x.com/2/lists/:id/tweets (Consulta los Tweets de una List especificada)
- attachments
- author_id
- context_annotations
- created_at
- geo
- lang
Te animamos a leer más sobre estos nuevos parámetros en sus respectivas guías, o leyendo nuestra guía sobre cómo usar fields y expansions.
También hemos elaborado una guía de migración de formatos de datos que puede ayudarte a mapear fields estándar v1.1 a los nuevos fields v2. Esta guía también te proporcionará los parámetros expansion y field específicos que necesitarás pasar con tu solicitud v2 para devolver fields específicos.
Además de los cambios en cómo solicitas ciertos fields, X API v2 también introduce nuevos diseños JSON para los objetos devueltos por las APIs, incluyendo objetos Post y user.
- En el nivel raíz del JSON, los endpoints estándar devuelven objetos Post en un array statuses, mientras que X API v2 devuelve un array data.
- En lugar de referirse a “statuses” Retweeted y Quoted, el JSON de X API v2 se refiere a Tweets Retweeted y Quoted. Se eliminan muchos fields heredados y deprecados, como contributors y user.translator_type.
- En lugar de usar tanto favorites (en el objeto Post) como favourites (en el objeto de usuario), X API v2 usa el término like.
- X está adoptando la convención de que los valores JSON sin valor (por ejemplo, null) no se escriben en el payload. Los atributos de Post y usuario solo se incluyen si tienen valores no nulos.
Ejemplos de código
Obtener Posts de una List (v2)
cURL