Saltar al contenido principal
Esta página contiene información sobre varias herramientas y conceptos clave que debe tener en cuenta al integrar los endpoints de búsqueda de usuarios en su sistema. Hemos dividido la página en un par de secciones diferentes:

​
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 comprender rápidamente qué tienes disponible. 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 compatible con los endpoints de la v2 buscando la etiqueta de versión correspondiente.

​
Conceptos clave

​
Autenticación

Todos los endpoints de X API v2 requieren que las solicitudes estén autenticadas con un conjunto de credenciales, también conocidas como claves y 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 las solicitudes a estos endpoints.  Contexto de usuario de OAuth 1.0a requiere que utilices tus API Keys, user Access Tokens y otros parámetros para crear un encabezado de autorización, que luego pasarás con tu solicitud. Los Access Tokens deben estar asociados con el usuario en cuyo nombre realizas la solicitud. Si deseas generar un conjunto de Access Tokens para otro usuario, ese usuario debe autorizar tu App mediante 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 librería, una herramienta como Postman o OAuth 2.0 para autenticar tus solicitudes. Si deseas solicitar un Post o métricas privadas desde estos endpoints, necesitarás usar Contexto de usuario de OAuth 1.0a o Código de autorización de OAuth 2.0 con PKCE, lo cual garantizará que cuentas con los permisos adecuados del usuario propietario de ese contenido.   App only solo requiere que pases un App only Access Token con tu solicitud. Puedes generar un App only Access Token directamente dentro de una App de desarrollador o generarlo usando el endpoint POST oauth2/token. Código de autorización de OAuth 2.0 con PKCE permite un mayor control sobre el scope 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 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. Ten en cuenta Si vas a solicitar los siguientes fields, se requiere Contexto de usuario de OAuth 1.0a o Código de autorización de OAuth 2.0: 
  • tweet.fields.non_public_metrics
  • tweet.fields.promoted_metrics
  • tweet.fields.organic_metrics

​
Portal de desarrolladores, Proyectos 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 Proyecto dentro de esa cuenta y crear una App de desarrollador dentro de ese Proyecto. Luego podrás encontrar tus claves y tokens en tu App de desarrollador.   

​
Límites de uso

Cada día, miles de desarrolladores realizan solicitudes a la X API. Para ayudar a gestionar el alto volumen de estas solicitudes, se aplican límites de uso a cada endpoint que restringen la cantidad de solicitudes que puedes realizar en nombre de tu App o de un usuario autenticado. Los endpoints de consulta de usuarios están sujetos a límites de uso tanto a nivel de App como a nivel de usuario. Sin embargo, el endpoint de consulta del usuario autenticado está limitado a nivel de usuario. El límite a nivel de App significa que tú, como desarrollador, solo puedes realizar una cantidad determinada de solicitudes a este endpoint durante un período de tiempo específico desde cualquier App (según las claves y tokens que estés utilizando). El límite a nivel de usuario significa que el usuario autenticado en cuyo nombre realizas la solicitud solo puede realizar una cantidad determinada de solicitudes a través de cualquier App de desarrollador. La siguiente tabla muestra los límites de uso para cada endpoint.
EndpointMétodo HTTPLímite de uso / Nivel
/2/usersGET900 solicitudes por 15 minutos / App y usuario
/2/users/:idGET900 solicitudes por 15 minutos / App y usuario
/2/users/byGET900 solicitudes por 15 minutos / App y usuario
/2/users/by/username/:usernameGET900 solicitudes por 15 minutos / App y usuario
/2/users/meGET75 solicitudes por 15 minutos / Usuario

​
Fields y expansions

La X API v2 permite seleccionar con precisión qué data se desea obtener de la API mediante un conjunto de herramientas llamadas fields y expansions. El parámetro expansions te permite expandir los objetos referenciados en el payload. Por ejemplo, este endpoint te permite usar la expansión pinned_tweet_id. El parámetro fields te permite seleccionar exactamente qué fields dentro de los distintos objetos de data deseas recibir. Estos endpoints entregan 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.location, deberás solicitarlos explícitamente usando el parámetro fields. Algunos campos importantes que podrías considerar en tu integración son los de datos de encuestas de Post, métricas, anotaciones y conversation ID. Hemos añadido una guía sobre cómo usar fields y expansions en nuestro X API v2 data dictionary.

​
Casos límite

  • El texto del Post se trunca en los Retweets. La solución temporal es expandir el Post referenciado y obtener el texto completo desde la expansión. Este es un error que corregiremos en el futuro.