Guía de integración

Esta página presenta herramientas y conceptos clave para integrar los endpoints de miembros de Listas.

---

​

Herramientas útiles

Antes de profundizar en algunos conceptos clave para integrar este endpoint, te recomendamos familiarizarte con lo siguiente:

​

Postman

Postman es una excelente herramienta que puedes usar para probar un endpoint. Cada solicitud de Postman incluye todos los parámetros de ruta y de cuerpo para ayudarte a comprender rápidamente qué tienes a tu disposición. Para obtener más información sobre nuestras colecciones de Postman, visita nuestra página “Uso de Postman”.

​

Ejemplos de código

¿Te interesa configurar este endpoint con código en tu lenguaje de programación preferido? Tenemos varios ejemplos de código disponibles que puedes usar como punto de partida en nuestra página de GitHub.

​

Bibliotecas de terceros

Aprovecha una de las bibliotecas de terceros de nuestras comunidades para empezar. Puedes encontrar una biblioteca que funcione con los endpoints v2 buscando la etiqueta de versión correcta.

---

​

Conceptos clave

​

Autenticación

Todos los endpoints de X API v2 requieren que autentiques tus solicitudes con un conjunto de credenciales, también conocidas como claves y tokens. Puedes usar OAuth 1.0a User Context, OAuth 2.0 Authorization Code with PKCE o App only para autenticar tus solicitudes para los endpoints de lookup de Listas. Sin embargo, debes autenticarte con OAuth 1.0a User Context o OAuth 2.0 para los endpoints de manage de Listas.

OAuth 1.0a User Context significa que debes usar un conjunto de API keys y Access Tokens de usuario para realizar una solicitud correctamente. Los Access Tokens deben estar asociados con el usuario en cuyo nombre estás realizando la solicitud. Si deseas generar un conjunto de Access Tokens para otro usuario, este debe autorizar tu App usando el flujo OAuth de 3 participantes.

Ten en cuenta que OAuth 1.0a puede ser difícil de usar. Si no estás familiarizado con este método de autenticación, te recomendamos que uses una biblioteca, una herramienta como Postman o que uses OAuth 2.0 o App only para autenticar tus solicitudes.

OAuth 2.0 Authorization Code with PKCE permite un mayor control sobre el ámbito (scope) de una aplicación y sobre los flujos de autorización en múltiples dispositivos. OAuth 2.0 te permite elegir scopes específicos y granulares que te otorgan permisos específicos en nombre de un usuario.

Para habilitar OAuth 2.0 en tu App, debes activarlo en la configuración de autenticación de tu App, que se encuentra en la sección de configuración de la App en la Consola de desarrollador.

App only solo requiere que pases un App only Access Token con tu solicitud. Puedes generar un App only Access Token directamente en una App de desarrollador o generar uno usando el endpoint POST oauth2/token.

​

Consola de desarrollador, proyectos y Apps de desarrollador

Para obtener un conjunto de credenciales de autenticación que funcionen con los endpoints de X API v2, debes registrarte para obtener una cuenta de desarrollador, configurar un Project dentro de esa cuenta y crear una developer App en ese Project. Luego podrás encontrar tus claves y tokens dentro de tu developer App.

​

Límites de tasa

Cada día, miles de desarrolladores realizan solicitudes a la X API. Para ayudar a gestionar el gran volumen de estas solicitudes, se aplican límites de tasa a cada endpoint, que limitan la cantidad de solicitudes que puedes hacer en nombre de tu App o en nombre de un usuario autenticado.

Los endpoints de consulta (GET) tienen límites de tasa tanto a nivel de App como a nivel de usuario, mientras que los endpoints de gestión (POST/DELETE) están limitados a nivel de usuario. El límite de tasa de la App significa que tú, como desarrollador, solo puedes hacer una cierta cantidad de solicitudes a este endpoint durante un período de tiempo determinado desde cualquier App (ya sea usando la API Key y la API Secret Key, o el App only Access Token). El límite de tasa del usuario significa que el usuario autenticado en cuyo nombre realizas la solicitud solo puede realizar una consulta de Lista un número determinado de veces a través de cualquier App de desarrollador.

La siguiente tabla muestra los límites de tasa para cada endpoint.

Endpoint	Método HTTP	Límite de tasa
/2/lists/:id/members	GET	900 solicitudes por 15 minutos
/2/users/:id/list_memberships	GET	75 solicitudes por 15 minutos
/2/lists/:id/members	POST	300 solicitudes por 15 minutos
/2/lists/:id/members/:user_id	DELETE	300 solicitudes por 15 minutos

​

Campos y expansions

El endpoint GET de X API v2 permite a los usuarios seleccionar exactamente qué datos quieren obtener de la API utilizando un conjunto de herramientas llamadas fields y expansions. El parámetro expansions te permite expandir los objetos referenciados en el payload. Por ejemplo, al consultar los miembros de una Lista puedes obtener las siguientes expansions:

• pinned_tweet_id

El parámetro fields te permite seleccionar exactamente qué fields dentro de los diferentes objetos de datos quieres recibir. La consulta de miembros de una Lista devuelve principalmente objetos de usuario. De forma predeterminada, el objeto de usuario devuelve los campos id, name y username. Para recibir campos adicionales como user.created_at o user.description, tendrás que solicitar específicamente esos campos utilizando un parámetro user.fields.

Hemos añadido una guía sobre cómo usar fields and expansions.

La siguiente tabla muestra los campos y expansions disponibles para cada endpoint de consulta:

Endpoint	Campos	Expansions
/2/lists/:id/members	user.fields, tweet.fields	pinned_tweet_id
/2/users/:id/list_memberships	list.fields, user.fields	owner_id

​

Paginación

Consultar membresías/miembros puede devolver muchos datos. Para garantizar que devolvemos resultados coherentes y de alto rendimiento en un momento dado, usamos paginación. La paginación es una característica de los endpoints de X API v2 que devuelven más resultados de los que se pueden incluir en una sola respuesta. Cuando eso ocurre, los datos se devuelven en una serie de “páginas”. Obtén más información sobre cómo paginar los resultados.