Skip to main content

​
Búsqueda de bloqueos: Standard v1.1 frente a X API v2

Si has estado trabajando con los endpoints de Standard v1.1 GET blocks/ids y GET blocks/list, el objetivo de esta guía es ayudarte a comprender las similitudes y diferencias entre los endpoints de búsqueda de bloqueos de Standard v1.1 y X API v2.
  • Similitudes
    • Autenticación
  • Diferencias
    • URLs de endpoint
    • Límite de usuarios por solicitud
    • Requisitos de App y Project
    • Formatos de data en las respuestas
    • Parámetros de solicitud

​
Similitudes

Autenticación Tanto los endpoints de búsqueda de bloqueos de Standard v1.1 como los de X API v2 utilizan Contexto de usuario de OAuth 1.0a. Por lo tanto, si anteriormente usabas uno de los endpoints de búsqueda de bloqueos de Standard 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 endpoint Límites de usuarios por solicitud Los endpoints de Standard v1.1 permiten devolver hasta 5000 usuarios por solicitud. Los endpoints de v2 permiten devolver hasta 1000 usuarios por solicitud. Para obtener los 1000 usuarios completos, debes pasar max_results=1000 como parámetro query; luego puedes pasar el next_token devuelto en la carga de la respuesta al parámetro query pagination_token en tu siguiente solicitud.   Requisitos de App y Project Los endpoints de X API v2 requieren que uses credenciales de una App de desarrollador que esté asociada con un Project al autenticar tus solicitudes. Todos los endpoints de X API v1.1 pueden usar credenciales de Apps independientes o Apps asociadas con un Project. Formato de datos de la respuesta Una de las mayores diferencias entre Standard v1.1 y las versiones de endpoint de X API v2 es cómo seleccionas qué campos se devuelven en la carga. En los endpoints Standard, recibes muchos de los campos de respuesta de manera predeterminada y, además, tienes la opción de usar parámetros para indicar qué campos o conjuntos de campos deben incluirse en la carga. La versión de X API v2 solo entrega de forma predeterminada los campos de usuario id, name y username. Para solicitar campos u objetos adicionales, debes usar los parámetros fields y expansions. Cualquier campo de usuario que solicites en este endpoint se devolverá en el objeto de usuario principal. Cualquier Objeto de Post expandido y sus campos se devolverán en un objeto includes dentro de tu respuesta. Luego puedes hacer coincidir cualquier objeto expandido con el objeto de usuario comparando los IDs presentes tanto en el usuario como en el Objeto de 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 campos de Standard v1.1 a los nuevos campos de v2. Esta guía también te proporcionará el parámetro específico de expansión y de campo que necesitarás incluir en tu solicitud v2 para devolver campos específicos.    Además de los cambios en cómo solicitas ciertos campos, X API v2 también introduce nuevos diseños JSON para los objetos devueltos por las APIs, incluidos los objetos de Post y user.
  • En el nivel raíz de JSON, los endpoints Standard devuelven Objetos de Post 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 campos heredados y obsoletos, como contributors y user.translator_type, están siendo eliminados. 
  • En lugar de usar tanto favorites (en el Objeto de Post) como favourites (en el objeto de usuario), 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 la carga. Los atributos de Post y de usuario solo se incluyen si tienen valores no nulos.   
También incorporamos un nuevo conjunto de campos en el Objeto de Post, incluidos los siguientes:
  • Un campo conversation_id
  • Dos nuevos campos de annotations, incluidos context y entities
  • Varios campos nuevos de metrics 
  • Un nuevo campo reply_setting, que indica quién puede responder a un Post determinado
Parámetros de solicitud Los siguientes parámetros de solicitud de Standard v1.1 aceptaban dos parámetros de query (user_id o screen_name). La X API v2 solo acepta el id de usuario numérico y debe pasarse como parte de la ruta del endpoint.
⌘I