Administrar Retweets

Administrar Retweets: v1.1 estándar en comparación con X API v2

Si has estado trabajando con los endpoints estándar de v1.1 POST statuses/retweet/:id y POST statuses/unretweet/:id, el objetivo de esta guía es ayudarte a comprender las similitudes y diferencias entre los endpoints de Retweets estándar y de X API v2.

• Similitudes
  • Autenticación
• Diferencias
  • URL de los endpoints y métodos HTTP
  • Limitaciones de solicitudes
  • Requisitos de la App y del Project
  • Parámetros de solicitudes

Similitudes

Autenticación

Tanto los endpoints estándar v1.1 como los de X API v2 que gestionan Retweets (POST statuses/retweet/:id y POST statuses/unretweet/:id) usan OAuth 1.0a User Context. Por lo tanto, si antes usabas uno de los endpoints estándar v1.1 para consultar Retweets, puedes seguir usando el mismo método de autenticación si migras a la versión de X API v2. 

Diferencias

URLs de endpoints y métodos HTTP

• Endpoints estándar v1.1:
  • https://api.x.com/1.1/statuses/retweet/:id.json (Realiza un Retweet de una Publicación. Devuelve la Publicación original con los detalles del Retweet incrustados)
  • https://api.x.com/1.1/statuses/unretweet/:id.json (Deshace un Retweet. Devuelve la Publicación original con los detalles del Retweet incrustados)
• Endpoint de X API v2:
  • https://api.x.com/2/tweets/:id/retweets (Realiza un Retweet de una Publicación determinada)
  • https://api.x.com/2/users/:id/retweets/:source_tweet_id (Deshace el Retweet de una Publicación determinada) 

Requisitos de App y Project

Los endpoints de X API v2 requieren que uses credenciales de una developer App que esté asociada a un Project al autenticar tus solicitudes. Todos los endpoints estándar de X API v1.1 pueden usar credenciales de Apps, tanto independientes como asociadas a un Project.

Parámetros de la solicitud

Los siguientes 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 del usuario, y debe pasarse como parte de la ruta del endpoint.

Estándar v1.1	X API v2
id	id
includes_entities	Sin equivalente

Ten en cuenta que los parámetros estándar v1.1 se pasan como parámetros de consulta, mientras que los parámetros de X API v2 se pasan como parámetros en el cuerpo para el endpoint POST o como parámetros de ruta para el endpoint DELETE.

Además, no es necesario indicar el id del usuario que hace Retweet de una Publicación cuando se usan los endpoints estándar v1.1, ya que los Access Tokens que se pasan con OAuth 1.0a User Context permiten inferir qué usuario está iniciando el Retweet o deshaciendo un Retweet.

---

Ejemplos de código

Retuitear una Publicación (v2)

cURL

shellscript

curl -X POST "https://api.x.com/2/users/123456789/retweets" \
  -H "Authorization: OAuth ..." \
  -H "Content-Type: application/json" \
  -d '{"tweet_id": "1234567890"}'

Deshacer un Retweet (v2)

cURL

shellscript

curl -X DELETE "https://api.x.com/2/users/123456789/retweets/1234567890" \
  -H "Authorization: OAuth ..."