Saltar al contenido principal
Esta página contiene información sobre varias herramientas y conceptos clave que debes conocer al integrar los endpoints de búsqueda de usuarios 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 puede usar para probar un endpoint. Cada solicitud de Postman incluye todos los parámetros de ruta y de cuerpo para ayudarle a comprender rápidamente qué tiene a su disposición. Para obtener más información sobre nuestras colecciones de Postman, visite nuestra página “Using Postman”. 

​
Ejemplos de código

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

​
Bibliotecas de terceros

Aprovecha alguna de las bibliotecas de terceros de nuestra comunidad para empezar. Puedes 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 las solicitudes estén autenticadas 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 las solicitudes a estos endpoints. Contexto de usuario de OAuth 1.0a requiere que utilices tus API Keys, Access Tokens de usuario y algunos otros parámetros para crear un encabezado de autorización, que luego incluirás en 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, este debe autorizar tu App utilizando el flujo de OAuth de 3 fases. Ten en cuenta que OAuth 1.0a puede ser complejo de usar. Si no estás familiarizado con este método de autenticación, te recomendamos utilizar una librería, usar una herramienta como Postman o usar OAuth 2.0 para autenticar tus solicitudes. Si deseas solicitar un Post o metrics privadas desde estos endpoints, deberás usar Contexto de usuario de OAuth 1.0a o Código de autorización de OAuth 2.0 con PKCE, lo que garantizará que cuentes con los permisos adecuados del usuario propietario de ese contenido. App only solo requiere que incluyas un App only Access Token en 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. Código de autorización de OAuth 2.0 con PKCE permite un mayor control sobre el scope de una aplicación y sobre 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 solicitas 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, Projects y Apps de desarrollador

Para obtener un conjunto de credenciales de autenticación que funcione 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 gran volumen de estas solicitudes, se aplican límites de tasa 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 búsqueda de usuarios tienen límites de tasa tanto a nivel de App como a nivel de usuario. Sin embargo, el endpoint de búsqueda del usuario autenticado tiene límite de tasa a nivel de usuario. El límite de tasa a nivel de App significa que tú, como desarrollador, solo puedes realizar una cierta cantidad de solicitudes a este endpoint durante un período de tiempo determinado desde cualquier App (según las keys and tokens que estés usando). El límite de tasa a nivel de usuario significa que el usuario autenticado en cuyo nombre haces la solicitud solo puede realizarla un número determinado de veces en cualquier App de desarrollador. La siguiente tabla muestra los límites de tasa para cada endpoint.
Endpointmétodo HTTPLímite de tasa / 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

​
Campos 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 expansion permite ampliar los objetos referenciados en el payload. Por ejemplo, este endpoint permite usar la expansión pinned_tweet_id. El parámetro fields permite seleccionar exactamente qué fields dentro de los distintos objetos de data desea recibir. Estos endpoints devuelven 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á solicitarlos explícitamente mediante un parámetro fields. Algunos campos importantes que podría considerar en su integración son los datos de encuestas de Post, metrics, annotations y los campos de conversation ID. Hemos añadido una guía sobre cómo usar fields y expansions en nuestro diccionario de datos de X API v2.

​
Casos extremos

  • El texto del Post se trunca en los Retweets. Como solución temporal a corto plazo, expanda el Post referenciado y recupere el texto completo desde la expansión. Es un error que corregiremos en el futuro.
⌘I