Skip to main content

​
Consulta de bloqueos: estándar v1.1 en comparación con X API v2

Si ha estado trabajando con los endpoints estándar v1.1 GET blocks/ids y GET blocks/list, el objetivo de esta guía es ayudarle a comprender las similitudes y diferencias entre los endpoints de consulta de bloqueos del estándar v1.1 y de X API v2.
  • Similitudes
    • Autenticación
  • Diferencias
    • URL de los endpoints
    • Límite de usuarios por solicitud
    • Requisitos de App y Project
    • Formatos de datos de respuesta
    • Parámetros de solicitud

​
Similitudes

Autenticación Tanto los endpoints de consulta de bloqueos estándar v1.1 como los de X API v2 usan Contexto de usuario de OAuth 1.0a. Por lo tanto, si antes usabas uno de los endpoints de consulta de bloqueos estándar v1.1, puedes seguir usando el mismo método de autenticación si migras a la versión de X API v2. 

​
Diferencias

URLs de endpoints Límites de usuarios por solicitud Los endpoints estándar v1.1 permiten devolver hasta 5000 usuarios por solicitud. Los endpoints v2 permiten devolver hasta 1000 usuarios por solicitud. Para devolver 1000 usuarios completos, debes pasar max_results=1000 como parámetro de consulta; luego puedes pasar el next_token devuelto en la carga de respuesta al parámetro de consulta pagination_token en tu siguiente solicitud.   Requisitos de App y Proyecto Los endpoints de X API v2 requieren que uses credenciales de una App de desarrollador asociada a un Proyecto al autenticar tus solicitudes. Todos los endpoints de X API v1.1 pueden usar credenciales de Apps Autónomo o Apps asociadas a un proyecto. Formato de datos de la respuesta Una de las mayores diferencias entre las versiones de 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, recibes muchos de los fields de respuesta de forma predeterminada y luego tienes la opción de usar parámetros para identificar qué fields o conjuntos de fields deben devolverse en el payload. La versión de X API v2 solo entrega de forma predeterminada los fields user id, name y username. Para solicitar cualquier field u objeto adicional, necesitas usar los parámetros fields y expansions. Cualquier user field que solicites desde este endpoint se devolverá en el objeto de usuario principal. Cualquier objeto Post expandido y sus fields se devolverán en un objeto includes dentro de tu respuesta. Luego puedes hacer coincidir cualquier objeto expandido con el objeto de usuario haciendo coincidir los ids ubicados tanto en el usuario como en el objeto Post expandido.  Te recomendamos leer más sobre estos nuevos parámetros en sus respectivas guías o consultar nuestra guía sobre cómo usar fields y expansions.  También hemos preparado una guía de migración de formato de datos que puede ayudarte a mapear los fields estándar v1.1 a los nuevos fields de v2. Esta guía también te proporcionará el parámetro específico de expansion y field 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, incluidos los objetos Post y user.
  • En el nivel raíz de 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 Retweeted y Quoted “statuses”, el JSON de X API v2 se refiere a Retweeted y Quoted Tweets. Muchos fields heredados y en desuso, 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 no nulos.   
También introdujimos un nuevo conjunto de fields en el objeto Post, que incluye lo siguiente:
  • Un field conversation_id
  • Dos nuevos fields de annotations, incluidos context y entities
  • Varios nuevos fields de metrics 
  • Un nuevo field reply_setting, que indica quién puede responder a un Post determinado
Parámetros de solicitud Los siguientes parámetros estándar de solicitud de v1.1 aceptaban dos parámetros de consulta (user_id o screen_name). X API v2 solo acepta el id de usuario numérico y debe pasarse como parte de la ruta del endpoint.