Skip to main content

​
Comparación de los endpoints de Posts lookup de la X API

Los endpoints v2 de Posts lookup reemplazan a los endpoints estándar v1.1 GET statuses/lookup y GET statuses/show. Esta guía es para desarrolladores que migran desde estas versiones anteriores a X API v2.

​
Tabla comparativa de endpoints

​
Standard v1.1 comparado con X API v2

Si has estado trabajando con los endpoints estándar v1.1 GET statuses/show y GET statuses/lookup, esta guía te ayudará a entender las similitudes y diferencias entre los endpoints estándar y los de X API v2 Posts lookup. También te puede interesar nuestra herramienta visual de migración de formato de datos para ayudarte a ver rápidamente las diferencias entre el formato de datos de X API v1.1 y el formato de X API v2.
  • Similitudes
    • OAuth 1.0a User Context
    • Límites de Posts por solicitud
    • Soporte para historial y metadatos de edición de Post
  • Diferencias
    • URLs de endpoint
    • Requisitos de App y Project
    • Formato de datos de respuesta
    • Parámetros de solicitud

​
Similitudes

​
Método de autenticación OAuth 1.0a User Context

El endpoint estándar admite OAuth 1.0a User Context, mientras que el nuevo endpoint de Post lookup de X API v2 admite tanto OAuth 1.0a User Context como OAuth 2.0 App-Only. Por lo tanto, si anteriormente utilizabas uno de los endpoints estándar v1.1 de Post lookup, puedes continuar usando el mismo método de autenticación si migras a la versión X API v2. La autenticación App-Only es probablemente la forma más sencilla de comenzar. Para aprender cómo generar un App Access Token, consulta esta guía de OAuth 2.0 App-only.

​
Límites de Posts por solicitud

El endpoint v1.1 GET statuses/lookup te permite especificar hasta 100 Posts por solicitud. Esto también aplica al endpoint GET /tweets. Para especificar 100 Posts completos, usa el parámetro ids como parámetro de consulta con una lista separada por comas de IDs de Post. Soporte para historial y metadatos de edición de Post Ambas versiones proporcionan metadatos que describen cualquier historial de edición. Consulta las referencias de la API de Post lookup y la página de fundamentos de edición de Posts para obtener más detalles.

​
Diferencias

​
URLs de endpoint

  • Endpoints Standard v1.1:
    • https://api.x.com/1.1/statuses/show
    • https://api.x.com/1.1/statuses/lookup
  • Endpoint X API v2:
    • https://api.x.com/2/tweets
    • https://api.x.com/2/tweets/:id

​
Requisitos de App y Project

Los endpoints de X API v2 requieren credenciales de una developer App asociada a un Project para la autenticación. Los endpoints de X API v1.1 pueden usar credenciales de Apps o Apps asociadas con una App.

​
Formato de datos de respuesta

Una diferencia significativa entre las versiones de endpoint estándar v1.1 y X API v2 es cómo se seleccionan los fields en el payload. Para los endpoints estándar, muchos fields de respuesta se incluyen por defecto, con opciones para usar parámetros para especificar fields adicionales. Sin embargo, X API v2 solo entrega los fields id y text del Post por defecto. Los fields y objetos adicionales requieren el uso de los parámetros fields y expansions. Los fields expandidos se devuelven en un objeto includes dentro de la respuesta, que puede coincidir con el objeto Post principal haciendo coincidir los IDs. Para obtener más información sobre el uso de fields y expansions, consulta la guía sobre cómo usar fields y expansions. Una guía de migración de formato de datos también mapea los fields estándar v1.1 a los fields v2 más recientes. Además, X API v2 introduce nuevos diseños JSON para los objetos, incluidos los objetos Post y user:
  • Los endpoints estándar devuelven objetos Post en un array statuses, mientras que X API v2 utiliza un array data.
  • Retweeted y Quoted Tweets en X API v2 reemplazan la terminología “statuses”.
  • Nueva terminología como like reemplaza términos como favorites y favourites.
  • Los atributos sin valores (por ejemplo, null) no se incluyen en los payloads de X API v2.
El objeto Post en X API v2 incluye nuevos fields como:
  • conversation_id
  • Dos nuevos campos de annotations (context y entities)
  • Nuevos campos de métricas
  • Campo reply_setting que muestra quién puede responder a un Post determinado

​
Parámetros de solicitud

Los siguientes parámetros de solicitud estándar v1.1 tienen equivalentes en X API v2: Ciertos parámetros estándar v1.1 no son compatibles con X API v2:

​
Solicitudes cURL

Las siguientes solicitudes cURL muestran endpoints estándar v1.1 y sus equivalentes v2. Reemplaza ACCESS_TOKEN en el encabezado con tu app access token. Para los endpoints v2, el token debe pertenecer a una developer App dentro de un Project. Los payloads de respuesta de v1.1 diferirán de v2. Con v2, puedes solicitar diferentes fields con los parámetros fields y expansions. Endpoints Standard v1.1 GET statuses/lookup y v2 GET /tweets
Endpoints Standard v1.1 GET statuses/show/:id y v2 GET /tweets/:id