Gestionar miembros de listas

Administrar miembros de Listas: Standard v1.1 comparado con X API v2

Si has estado trabajando con los endpoints estándar de v1.1 POST lists/members/create y POST lists/members/destroy, el objetivo de esta guía es ayudarte a comprender las similitudes y diferencias entre los endpoints estándar de v1.1 y de X API v2 para administrar miembros de Listas.

• Similitudes
  • Autenticación
• Diferencias
  • URL de los endpoints
  • Requisitos de App y Proyecto
  • Métodos HTTP
  • Límites de tasa
  • Parámetros de solicitud

Similitudes

Autenticación

Ambas versiones del endpoint son compatibles con OAuth 1.0a User Context. Por lo tanto, si antes utilizabas uno de los endpoints estándar de v1.1 para administrar miembros de Listas, puedes seguir usando 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/lists/members/create.json (Agrega un miembro a una Lista específica)
  • POST https://api.x.com/1.1/lists/members/destroy.json (Elimina un miembro de una Lista específica)
• Endpoint de X API v2:

  • POST https://api.x.com/2/lists/:id/members (Agrega un miembro a una Lista específica)

  • DELETE https://api.x.com/2/lists/:id/members/:user_id (Elimina un miembro de una Lista específica)

Límites de tasa

Standard v1.1	X API v2
/1.1/lists/members/create.json none	/2/lists/:id/members 300 solicitudes por ventana de 15 minutos con contexto de usuario de OAuth 1.0a 300 solicitudes por ventana de 15 minutos con el flujo Authorization Code de OAuth 2.0 con PKCE
/1.1/lists/members/destroy.json none	/2/lists/:id/members/:user_id 300 solicitudes por ventana de 15 minutos con contexto de usuario de OAuth 1.0a 300 solicitudes por ventana de 15 minutos con el flujo Authorization Code de OAuth 2.0 con PKCE

Requisitos de App y Project

Los endpoints de X API v2 requieren que utilices credenciales de una developer App que esté asociada con 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 de Standard v1.1 tienen equivalentes en X API v2:

Standard v1.1	X API v2
list_id	id
slug	Sin equivalente
screen_name	Sin equivalente
owner_screen_name	Sin equivalente
owner_id	Sin equivalente