Saltar al contenido principal
Esta página contiene información sobre varias herramientas y conceptos fundamentales que debe conocer al integrar el endpoint de consulta de Posts de una List en su sistema. Hemos dividido la página en varias secciones:

​
Herramientas útiles

Antes de profundizar en algunos conceptos clave que le ayudarán a integrar este endpoint, le recomendamos familiarizarse con:

​
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 disponible. Para obtener más información sobre nuestras colecciones de Postman, visita nuestra página “Using Postman”. 

​
Ejemplos de código

¿Le interesa configurar este endpoint con código en su lenguaje de programación preferido? Contamos con varios ejemplos de código que puede usar como punto de partida en nuestra página de GitHub.

​
Bibliotecas de terceros

Aproveche una de las bibliotecas de terceros de nuestra comunidad para empezar. Puede encontrar una biblioteca compatible con los endpoints de v2 buscando la etiqueta de versión correspondiente.

​
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 keys and tokens. Puedes usar Contexto de usuario de OAuth 1.0a, App only o Código de autorización de OAuth 2.0 con PKCE para autenticar tus solicitudes a este endpoint. Contexto de usuario de OAuth 1.0a, lo que significa que debes usar un conjunto de API Keys y Access Tokens de usuario para realizar una solicitud correcta. 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, ese usuario debe autorizar tu App mediante el flujo de OAuth de 3 fases. 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 usar una biblioteca, una herramienta como Postman o bien usar OAuth 2.0 o App only para autenticar tus solicitudes. Código de autorización de OAuth 2.0 con PKCE permite un mayor control sobre el alcance de una aplicación y flujos de autorización en múltiples dispositivos. OAuth 2.0 te permite elegir scopes específicos y granulares que te otorgan permisos concretos en nombre de un usuario. Para habilitar OAuth 2.0 en tu App, debes habilitarlo en la configuración de autenticación de tu App, ubicada en la sección de configuración de la App del portal de desarrolladores. App only solo requiere que envíes un App only Access Token con tu solicitud. Puedes generar un App only Access Token directamente dentro de una App de desarrollador o generar uno usando el endpoint POST oauth2/token.

​
Portal de desarrolladores, Projects y Apps de desarrollador

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

​
Límites de tasa

Cada día, muchos miles de desarrolladores realizan solicitudes a la X API. Para ayudar a gestionar el volumen de estas solicitudes, se aplican límites de tasa a cada endpoint que limitan la cantidad de solicitudes que puedes realizar en nombre de tu App o de un usuario autenticado. Este endpoint está sujeto a límites de tasa tanto a nivel de App como a nivel de usuario. El límite de tasa de la App significa que tú, como desarrollador, solo puedes realizar una cierta cantidad de solicitudes a este endpoint durante un periodo de tiempo determinado desde cualquier App (ya sea usando la API Key y la Clave secreta de la API, o el Bearer Token). El límite de tasa por usuario significa que el usuario autenticado en cuyo nombre estás realizando la solicitud solo puede efectuar una consulta de Posts de una List un número determinado de veces, independientemente del App de desarrollador. La siguiente tabla muestra los límites de tasa para cada endpoint.
Endpointmétodo HTTPlímite de tasa
/2/lists/:id/tweetsGET900 solicitudes por 15 minutos
Fields and expansions El endpoint GET de X API v2 permite a los usuarios seleccionar exactamente qué datos desean obtener de la API usando un conjunto de herramientas llamadas fields y expansions. El parámetro expansions te permite incluir objetos referenciados en el payload. Por ejemplo, consultar Posts de una List permite obtener las siguientes expansions:
  • author_id
El parámetro fields te permite seleccionar exactamente qué fields dentro de los distintos objetos de datos quieres recibir. Este endpoint entrega principalmente Objetos de Post. De forma predeterminada, el Objeto de Post devuelve los campos id y text. Para recibir campos adicionales como tweet.created_at o tweet.lang, tendrás que solicitarlos específicamente usando un parámetro fields. Hemos añadido una guía sobre cómo usar fields y expansions juntos en nuestro diccionario de datos de X API v2. La siguiente tabla muestra los fields y expansions disponibles para el endpoint de consulta:
EndpointFieldsExpansions
/2/lists/:id/tweetstweet.fields

user.fields		author_id
Paginación Consultar Posts de una List puede devolver muchos datos. Para garantizar resultados coherentes y de alto rendimiento en todo momento, utilizamos paginación. La paginación es una funcionalidad en los endpoints de X API v2 que devuelven más resultados de los que se pueden incluir en una única 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.
⌘I