Skip to main content

​
Consulta de Me gusta: estándar v1.1 frente a X API v2

Si has estado trabajando con el endpoint estándar v1.1 GET favorites/list, el objetivo de esta guía es ayudarte a entender las similitudes y diferencias entre los endpoints de consulta de Me gusta del estándar v1.1 y de X API v2. Con v2, también hemos introducido un nuevo endpoint de usuarios que dieron Me gusta, que te permite obtener información sobre los usuarios a los que les gusta un Post.
  • Similitudes
    • Autenticación
    • Límite de solicitudes
  • Diferencias
    • URLs de los endpoints
    • Limitaciones de la solicitud
    • Requisitos de App y Project
    • Parámetros de la solicitud
    • Nuevo formato JSON

​
Similitudes

Autenticación Tanto los endpoints de consulta de likes de la versión estándar v1.1 como de X API v2 usan Contexto de usuario de OAuth 1.0a o OAuth 2.0 Bearer Token. Por lo tanto, si antes usabas los endpoints estándar v1.1 GET favorites/list, puedes seguir usando el mismo método de autenticación si migras a la versión de X API v2, si así lo deseas. Según la biblioteca o paquete de autenticación que elijas, la autenticación con Bearer Token probablemente sea la forma más fácil de empezar y se puede configurar con un encabezado de solicitud sencillo. Para aprender a generar un Bearer Token, consulta esta guía de OAuth 2.0 Bearer Token. Límites de frecuencia El endpoint estándar v1.1 GET favorites/list tiene un límite de 75 solicitudes por 15 minutos por usuario. El endpoint correspondiente de Posts marcados con “Me gusta” en v2 también tiene este mismo límite. Sin embargo, este endpoint de v2 también tiene un límite adicional de 75 solicitudes por 15 minutos por App.

​
Diferencias

URLs de endpoints Limitaciones de la solicitud El endpoint de v2 para Posts con “me gusta” permite solicitar de 5 a 100 Posts por solicitud, pero puedes obtener todos los “me gusta” de un Post usando tokens de paginación. El endpoint v1.1 GET favorites/list también permite obtener todos los “me gusta” de Posts, pero puedes extraer de 20 a 200 Posts por solicitud. Para el endpoint de usuarios que indican “me gusta” en v2, el límite es de 100 usuarios por Post.    Requisitos de App y Project Los endpoints de X API v2 requieren que uses credenciales de una developer App asociada a un Project al autenticar tus solicitudes. Todos los endpoints de X API v1.1 pueden usar credenciales de Apps autónomas o Apps asociadas a un proyecto. Parámetros de la solicitud Los endpoints estándar v1.1 aceptaban dos parámetros de consulta (user_id o screen_name). X API v2 solo acepta el ID numérico de usuario, y debe pasarse como parte de la ruta del endpoint. Una de las mayores diferencias entre los endpoints estándar v1.1 y X API v2 es cómo seleccionas qué fields se devuelven en tu payload. En los endpoints estándar, había varios parámetros para indicar qué fields o conjuntos de fields se devolverían en el payload, mientras que la versión de X API v2 simplifica estos parámetros en fields y expansions.    Nuevo formato JSON X API v2 introduce nuevos diseños JSON para los objetos devueltos por las APIs, incluidos los objetos Post y user.
  • En el nivel raíz de JSON, los endpoints estándar devuelven objetos de usuario en un arreglo statuses, mientras que X API v2 devuelve un arreglo data. 
  • En lugar de referirse a “statuses” Retweeted y Quoted, el JSON de X API v2 se refiere a Tweets Retweeted y Quoted. Muchos fields heredados y obsoletos, como contributors y user.translator_type, se están eliminando. 
  • En lugar de usar tanto favorites (en el objeto Post) como favourites (en el objeto user), X API v2 usa el término like. 
  • X adopta la convención de que los valores JSON sin valor (por ejemplo, null) no se escriben en el payload. Los atributos de Post y user solo se incluyen si tienen valores distintos de null.  
Además de los cambios que hicimos en el nuevo formato JSON, también introdujimos un nuevo conjunto de fields en el objeto Post, incluidos los siguientes: