Skip to main content

​
Búsqueda de likes: Standard v1.1 en comparación con X API v2

Si has estado trabajando con el endpoint Standard v1.1 GET favorites/list, el objetivo de esta guía es ayudarte a comprender las similitudes y diferencias entre Standard v1.1 y los endpoints de búsqueda de likes de X API v2. Con v2, también hemos introducido un nuevo endpoint de usuarios que dieron like, que te permite obtener información sobre los usuarios a los que les gustó un Post.
  • Similitudes
    • Autenticación
    • Límites de velocidad
  • Diferencias
    • URLs de endpoint
    • 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 Standard v1.1 como de X API v2 utilizan Contexto de usuario de OAuth 1.0a o OAuth 2.0 Bearer Token. Por lo tanto, si antes usabas los endpoints GET favorites/list de Standard v1.1, 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 sencilla de comenzar y puede configurarse con un encabezado de solicitud simple. Para aprender a generar un Bearer Token, consulta esta guía de OAuth 2.0 Bearer Token. Límites de velocidad El endpoint GET favorites/list de Standard v1.1 tiene un límite de 75 solicitudes por 15 minutos por usuario. El endpoint correspondiente de Posts con like en v2 tiene el mismo límite de velocidad. Sin embargo, este endpoint de v2 también tiene un límite de velocidad adicional de 75 solicitudes por 15 minutos por App.

​
Diferencias

URLs de endpoint Limitaciones de la solicitud El endpoint de Posts con like en v2 permite solicitar de 5 a 100 Posts por solicitud, pero puedes obtener todos los likes de un Post usando tokens de paginación. El endpoint GET favorites/list de v1.1 también permite obtener todos los likes de Posts, pero puedes recuperar de 20 a 200 Posts por solicitud. Para el endpoint de usuarios que dan like en v2, el límite es de 100 usuarios que dieron like por Post.    Requisitos de App y Project Los endpoints de X API v2 requieren que utilices 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 independientes o Apps asociadas a un proyecto. Parámetros de la solicitud En Standard v1.1, los endpoints correspondientes 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 las versiones de endpoints de Standard v1.1 y X API v2 es cómo seleccionas qué campos se devuelven en el payload. En los endpoints estándar había varios parámetros para indicar qué campos o conjuntos de campos 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 de JSON para los objetos devueltos por las APIs, incluidos los objetos de Post y de usuario.
  • En el nivel raíz de JSON, los endpoints estándar devuelven objetos de usuario 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. Muchos campos heredados y obsoletos, como contributors y user.translator_type, se están eliminando. 
  • En lugar de usar tanto favorites (en el Objeto de Post) como favourites (en el objeto de usuario), X API v2 utiliza el término like. 
  • X adopta la convención de que los valores de JSON sin valor (por ejemplo, null) no se escriben en el payload. Los atributos de Post y de usuario solo se incluyen si tienen valores distintos de null.  
Además de los cambios realizados en el nuevo formato JSON, también se introdujo un nuevo conjunto de campos en el Objeto de Post, que incluye lo siguiente:
⌘I