Consulta de miembros de Listas

Consulta de miembros de Listas: estándar v1.1 en comparación con X API v2

Si has estado trabajando con los endpoints estándar v1.1 GET lists/members y GET lists/memberships, el objetivo de esta guía es ayudarte a comprender las similitudes y diferencias entre la versión estándar v1.1 y los endpoints de miembros de Listas en X API v2.

• Similitudes
  • Métodos de autenticación
• Diferencias
  • URLs de los endpoints
  • Límites de tasa
  • Requisitos de App y de Project
  • Límites de objetos de datos por solicitud
  • Formatos de datos de respuesta
  • Parámetros de solicitud

Similitudes

Autenticación

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

Según la biblioteca o paquete de autenticación que elijas, la autenticación App only probablemente sea la forma más sencilla de comenzar y puede configurarse con un encabezado de solicitud sencillo. Para saber cómo generar un token de acceso App only, consulta esta guía de App only.

Diferencias

URLs de endpoints

• Endpoints estándar v1.1:
  • GET https://api.x.com/1.1/lists/members.json (Consulta de miembros de una Lista determinada)
  • GET https://api.x.com/1.1/lists/memberships.json (Consulta de Listas de las que un usuario es miembro)
• Endpoint de X API v2:

  • GET https://api.x.com/2/lists/:id/members (Consulta de miembros de una Lista determinada)

  • GET https://api.x.com/2/users/:id/list_memberships (Consulta de Listas de las que un usuario es miembro)

Límites de tasa

Estándar v1.1	X API v2
/1.1/lists/members.json 900 solicitudes por ventana de 15 minutos con contexto de usuario de OAuth 1.0a 15 solicitudes por ventana de 15 minutos solo con App	/2/lists/:id/members 900 solicitudes por ventana de 15 minutos con contexto de usuario de OAuth 1.0a 900 solicitudes por ventana de 15 minutos con OAuth 2.0 Authorization Code with PKCE 900 solicitudes por ventana de 15 minutos solo con App
/1.1/lists/memberships.json 15 solicitudes por ventana de 15 minutos con contexto de usuario de OAuth 1.0a 15 solicitudes por ventana de 15 minutos solo con App	/2/users/:id/list_memberships 15 solicitudes por ventana de 15 minutos con contexto de usuario de OAuth 1.0a 15 solicitudes por ventana de 15 minutos con OAuth 2.0 Authorization Code with PKCE 15 solicitudes por ventana de 15 minutos solo con App

Requisitos de App y Proyecto

Los endpoints de X API v2 requieren que uses credenciales de una App de desarrollador que esté asociada con un Proyecto al autenticar tus solicitudes. Todos los endpoints de X API v1.1 pueden usar credenciales de Apps o de Apps asociadas con un proyecto.

Límites de objetos de datos por solicitud

El endpoint estándar v1.1 /1.1/lists/members permite devolver hasta 5000 usuarios por solicitud. Los nuevos endpoints v2 permiten devolver hasta 100 usuarios por solicitud. De forma predeterminada, se devolverán 100 objetos de usuario; para cambiar el número de resultados tendrás que pasar un parámetro de consulta max_results= con un número entre 1-100; luego puedes pasar el next_token devuelto en el cuerpo de la respuesta al parámetro de consulta pagination_token en tu siguiente solicitud.

Además, el endpoint /1.1/lists/memberships permite devolver hasta 1000 Listas por solicitud. Con el endpoint equivalente en v2, se permiten hasta 100 Listas por solicitud. De forma predeterminada se devuelven 100 objetos de Lista; usa los parámetros de consulta max_results= y pagination_token de la misma manera que en /1.1/lists/members para cambiar el número de resultados.

Formato de datos de respuesta

Una de las diferencias más importantes entre las versiones de endpoints estándar v1.1 y X API v2 es cómo seleccionas qué campos se devuelven en tu carga útil (payload).

En los endpoints estándar, recibes muchos de los campos de respuesta de forma predeterminada y luego tienes la opción de usar parámetros para identificar qué campos adicionales o conjuntos de campos se deben devolver en la carga útil.

La versión de X API v2 /users/:id/list_memberships entregará de forma predeterminada los campos de id y nombre de la Lista. Para solicitar campos u objetos adicionales, tendrás que usar los parámetros fields y expansions. Cualquier campo de Lista que solicites desde este endpoint se devolverá en el objeto de Lista principal. Cualquier objeto y campos expandidos se devolverán en un objeto includes dentro de tu respuesta. Luego puedes hacer coincidir cualquier objeto expandido con el objeto de Lista principal haciendo coincidir las id ubicadas tanto en el objeto principal como en el expandido. 

Aquí tienes ejemplos de posibles campos de Lista y expansions:

• created_at

• follower_count

• member_count

• owner_id

• description

• private

Endpoint	Expansion
/2/lists/:id/members	pinned_tweet_id
/2/users/:id/list_memberships	owner_id

Te recomendamos leer más sobre estos nuevos parámetros en sus respectivas guías, o en nuestra guía sobre cómo usar fields y expansions. 

También hemos preparado una guía de migración de formato de datos que puede ayudarte a mapear los campos estándar de la v1.1 a los campos más recientes de la v2. Esta guía también te proporcionará los parámetros de expansión y de campos específicos que deberás incluir en tu solicitud de la v2 para devolver campos concretos. 

Además de los cambios en cómo solicitas ciertos campos, X API v2 también está introduciendo nuevos diseños JSON para los objetos que devuelven las API, incluidos los objetos de Publicación y de usuario.

• En el nivel raíz del JSON, los endpoints estándar devuelven objetos de Publicación en un array statuses, mientras que X API v2 devuelve un array data. 

• En lugar de hacer referencia a “statuses” Retweeted y Quoted, el JSON de X API v2 hace referencia a Tweets retuiteados y citados. Muchos campos heredados y obsoletos, como contributors y user.translator_type, se están eliminando. 

• En lugar de usar tanto favorites (en el objeto de Publicación) como favourites (en el objeto de usuario), X API v2 usa el término like. 

• X está adoptando la convención de que los valores JSON sin contenido (por ejemplo, null) no se escriben en la carga útil. Los atributos de Publicación y usuario solo se incluyen si tienen valores distintos de null.

Parámetros de solicitud

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

Búsqueda de miembros de Lista

v1.1 estándar	X API v2
list_id	id
slug	Sin equivalente
owner_screen_name	Sin equivalente
owner_id	Sin equivalente
count	max_results
cursor	pagination_token
include_entities	Sin equivalente
skip_status	Sin equivalente

Búsqueda de pertenencia a Lista

v1.1 estándar	X API v2
user_id	id
screen_name	Sin equivalente
count	max_results
cursor	pagination_token