De v1 a v2

Gestionar seguimientos: estándar v1.1 frente a X API v2

Si ha estado trabajando con los endpoints estándar de v1.1 POST friendships/create y POST friendships/destroy, el objetivo de esta guía es ayudarle a entender las similitudes y diferencias entre los endpoints para gestionar seguimientos del estándar y de X API v2.

• Similitudes
  • Contexto de usuario de OAuth 1.0a
• Diferencias

  • URL de endpoints

  • Requisitos de App y de Proyecto

  • Métodos HTTP

  • Parámetros de la solicitud

     

Similitudes

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

Ambas versiones del endpoint admiten OAuth 1.0a User Context. Por lo tanto, si antes utilizabas uno de los endpoints estándar de v1.1 para gestionar seguimientos, puedes seguir usando el mismo método de autenticación si migras a la versión de X API v2. 

Diferencias

URLs de los endpoints

• Endpoints estándar v1.1:
  • POST https://api.x.com/1.1/friendships/create.json (seguir a un usuario)
  • POST https://api.x.com/1.1/friendships/destroy.json (dejar de seguir a un usuario)
• Endpoint de X API v2:
  • POST https://api.x.com/2/users/:id/following (seguir a un usuario)
  • DELETE https://api.x.com/2/users/:source_user_id/following/:target_user_id (dejar de seguir a un usuario) 

Requisitos de App y Proyecto

Los endpoints de X API v2 requieren que utilice credenciales de una App de desarrollador que esté asociada a un Proyecto al autenticar sus solicitudes. Todos los endpoints de X API v1.1 pueden usar credenciales de Apps autónomas o Apps asociadas a un proyecto.

Parámetros de solicitud

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

Estándar v1.1	X API v2
Sin equivalente	id (POST), source_user_id (DELETE)
user_id	target_user_id
screen_name	Sin equivalente

Tenga 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 del cuerpo (para el endpoint POST) o parámetros de ruta (para el endpoint DELETE).

Además, el id y source_user_id de v2 no son requeridos cuando se usan los endpoints estándar de v1.1, ya que los tokens de acceso pasados con Contexto de usuario de OAuth 1.0a infieren qué usuario inicia el seguir o dejar de seguir.