v1 a v2

Gestionar seguimientos: estándar v1.1 en comparación con X API v2

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

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

Similitudes

Método de autenticación OAuth 1.0a en contexto de usuario

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

Diferencias

URLs de 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 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 o de 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
Sin equivalente	id (POST), source_user_id (DELETE)
user_id	target_user_id
screen_name	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 parámetros de ruta (para el endpoint DELETE).

Además, en v2, id y source_user_id no son obligatorios cuando se utilizan los endpoints estándar v1.1, ya que los tokens de acceso enviados con el contexto de usuario de OAuth 1.0a permitían inferir qué usuario estaba iniciando la acción de seguir o dejar de seguir.

---

Ejemplos de código

Seguir a un usuario (v2)

cURL

shellscript

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

Dejar de seguir a un usuario (v2)

cURL

shellscript

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