Gestionar Me gusta

Administrar Me gusta: Standard v1.1 en comparación con X API v2

Si has estado trabajando con los endpoints estándar v1.1 POST favorites/create y POST favorites/destroy, el objetivo de esta guía es ayudarte a comprender las similitudes y diferencias entre los endpoints estándar v1.1 y los endpoints de administración de Me gusta de X API v2.

• Similitudes
  • Contexto de usuario OAuth 1.0a
• Diferencias
  • URLs de endpoints y métodos HTTP
  • Requisitos de App y de proyecto
  • Parámetros de solicitud

Similitudes

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

Ambas versiones del endpoint admiten OAuth 1.0a User Context. Por lo tanto, si antes utilizabas alguno de los endpoints estándar de v1.1 para administrar favoritos, puedes seguir utilizando el mismo método de autenticación al migrar a la versión de X API v2.

Diferencias

URLs de endpoint y métodos HTTP

• Endpoints estándar v1.1:
  • POST https://api.x.com/1.1/favorites/create.json (indicar Me gusta en una Publicación)
  • POST https://api.x.com/1.1/favorites/destroy.json (quitar Me gusta de una Publicación)
• Endpoint de X API v2:
  • POST https://api.x.com/2/tweets/:id/likes (indicar Me gusta en una Publicación)
  • DELETE https://api.x.com/2/tweets/:id/likes/:tweet_id (quitar Me gusta de una Publicación) 

Requisitos de App y Project

Los endpoints de X API v2 requieren que utilices credenciales de una developer App que esté 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 Project.

Parámetros de la solicitud

Los siguientes parámetros de solicitud estándar v1.1 tienen equivalentes en X API v2:

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 se requiere un id del usuario que indica Me gusta en una Publicación cuando se utilizan los endpoints estándar v1.1, ya que los Access Tokens que se pasan con el OAuth 1.0a User Context permiten determinar qué usuario está iniciando la acción de indicar o quitar el Me gusta.

---

Ejemplos de código

Dar “Me gusta” a una Publicación (v2)

cURL

shellscript

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

Quitar el Me gusta de una Publicación (v2)

cURL

shellscript

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