Skip to main content

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 limits

Diferencias

URLs de endpoints Requisitos de App y Project Los endpoints de X API v2 requieren que uses credenciales de una App de desarrollador asociada a un Project al autenticar tus solicitudes. Todos los endpoints de X API v1.1 pueden usar credenciales de Apps o Apps asociadas a un project. Límites de objetos de datos por solicitud El endpoint estándar v1.1 /lists/statuses te permite devolver hasta 5000 Posts por solicitud. Los nuevos endpoints v2 te permiten devolver hasta 100 Posts por solicitud. Por defecto, se devuelven 100 objetos de usuario; para cambiar el número de resultados deberás pasar un parámetro de consulta max_results= con un número entre 1-100; luego puedes pasar el next_token devuelto en el payload de respuesta al parámetro de consulta pagination_token en tu siguiente solicitud. Formato de datos de respuesta Una de las mayores diferencias entre las versiones estándar v1.1 y X API v2 del endpoint es cómo seleccionas qué fields se devuelven en tu payload. Para los endpoints estándar, recibes muchos de los fields de respuesta por defecto y tienes la opción de usar parámetros para identificar qué fields o conjuntos de fields adicionales deben devolverse en el payload. La versión de X API v2 solo entrega los fields id y text de Post por defecto. Para solicitar fields u objetos adicionales, deberás usar los parámetros fields y expansions. Cualquier field de Post que solicites desde este endpoint se devolverá en el objeto Post principal. Cualquier field de objeto expandido se devolverá en un objeto includes dentro de tu respuesta. Luego puedes emparejar los objetos expandidos con el objeto Post principal coincidiendo los IDs del objeto principal y de los objetos expandidos. Aquí hay ejemplos de posibles fields y expansions de Post:
  • 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.
Parámetros de solicitud Los siguientes parámetros de solicitud estándar v1.1 tienen equivalentes en X API v2:

Ejemplos de código

Obtener Posts de una List (v2)

cURL