Saltar al contenido principal
Esta página contiene información sobre varias herramientas y conceptos fundamentales que debes conocer al integrar el endpoint de consulta de Posts de lista en tu 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 que se familiarice 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 entender rápidamente qué está disponible para ti. 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 de v2 buscando la etiqueta de versión adecuada.

​
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 Contexto de usuario de OAuth 1.0a, solo App o Código de autorización de OAuth 2.0 con PKCE para autenticar tus solicitudes a este endpoint. OAuth 1.0a User Context, 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 haces la solicitud. Si deseas generar un conjunto de Access Tokens para otro usuario, ese usuario debe autorizar tu App usando el flujo OAuth de 3 patas. 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 usar OAuth 2.0 o solo App 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 ámbitos granulares específicos que te otorgan permisos concretos 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, ubicada en la sección de configuración de la App del Portal de desarrolladores. App only solo requiere que incluyas 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.

​
Portal de desarrolladores, Proyectos y Apps de desarrollador

Para obtener un conjunto de credenciales de Autenticación que funcione 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 App de desarrollador dentro de ese Project. Luego podrás encontrar tus claves y tokens dentro de tu App de desarrollador.  

​
Límites de uso

Cada día, miles de desarrolladores realizan solicitudes a la X API. Para gestionar el gran volumen de solicitudes, se aplican límites de uso a cada endpoint, que restringen la cantidad de solicitudes que puedes hacer en nombre de tu App o de un usuario autenticado. Este endpoint tiene límites de uso tanto a nivel de App como a nivel de usuario. El límite de la App significa que tú, como desarrollador, solo puedes realizar un número determinado de solicitudes a este endpoint durante un periodo de tiempo concreto desde cualquier App (usando la API Key y la API Secret Key, o el Bearer Token). El límite de usuario significa que el usuario autenticado en cuyo nombre haces la solicitud solo puede realizar una consulta de Posts de Lista un número determinado de veces desde cualquier App de desarrollador. La tabla a continuación muestra los límites de uso para cada endpoint.
EndpointMétodo HTTPLímite de uso
/2/lists/:id/tweetsGET900 solicitudes por 15 minutos
Campos y expansions El endpoint GET de X API v2 permite seleccionar exactamente qué datos se desean obtener de la API mediante un conjunto de herramientas llamadas fields y expansions. El parámetro expansions permite expandir objetos referenciados en el payload. Por ejemplo, consultar Posts de Lista permite obtener las siguientes expansions:
  • author_id
El parámetro fields te permite seleccionar exactamente qué fields dentro de los distintos objetos de datos deseas recibir. Este endpoint entrega principalmente objetos Post. De forma predeterminada, el objeto Post devuelve los campos id y text. Para recibir campos adicionales como tweet.created_at o tweet.lang, tendrás que solicitarlos específicamente utilizando un parámetro fields. Hemos añadido una guía sobre cómo usar fields y expansions conjuntamente en nuestro diccionario de datos de X API v2.  La tabla a continuación 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 Lista puede devolver una gran cantidad de datos. Para garantizar que devolvemos resultados consistentes y de alto rendimiento en todo momento, 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 sucede, los datos se devuelven en una serie de “páginas”. Obtén más información sobre cómo paginar resultados.