Consulta de usuario autenticado

​

Introducción al endpoint Authenticated User Lookup

Esta guía de inicio rápido le ayudará a realizar su primera solicitud al endpoint authenticated user lookup con Postman.

Visite nuestro repositorio de GitHub X API v2 sample code si desea ver ejemplos de código en diferentes lenguajes.

​

Requisitos previos

Para completar esta guía, necesitará un conjunto de keys and tokens para autenticar su solicitud. Puede generar estas keys and tokens siguiendo estos pasos:

• Regístrese para obtener una developer account y espere la aprobación.
• Cree un Project y una developer App asociada en el Portal de desarrolladores.
• Vaya a la página “Keys and tokens” de su App para generar las credenciales necesarias. Asegúrese de guardar todas las credenciales en un lugar seguro.

​

Pasos para crear una solicitud de búsqueda del usuario autenticado

​

Paso uno: Comienza con una herramienta o biblioteca

Existen varias herramientas, ejemplos de código y bibliotecas que puedes usar para realizar una solicitud a este endpoint, pero aquí utilizaremos Postman para simplificar el proceso.

Para cargar en tu entorno la colección de Postman de X API v2, haz clic en el siguiente botón:

Agregar X API v2 a Postman

Una vez que tengas cargada en Postman la colección de X API v2, navega a la carpeta “Authenticated User Lookup” y selecciona “Lookup an Authenticated User”.

​

Paso dos: Autentica tu solicitud

Para realizar correctamente una solicitud a la X API, debes verificar que tienes permiso. Para hacerlo con este endpoint, debes autenticar tu solicitud usando Contexto de usuario de OAuth 1.0a o Código de autorización de OAuth 2.0 con PKCE.

En este ejemplo, usaremos el Contexto de usuario de OAuth 1.0a.

Debes agregar tus claves y tokens —específicamente tu API Key, API Secret Key, OAuth 1.0a user Access Token y OAuth 1.0a user Access Token Secret— en Postman. Puedes hacerlo seleccionando el entorno llamado “X API v2” en la esquina superior derecha de Postman y agregando tus claves y tokens en los campos “initial value” y “current value” (haciendo clic en el ícono de ojo junto al selector de entorno).

Estas variables se incorporarán automáticamente en la pestaña de autorización de la solicitud si lo has hecho correctamente.  

Paso tres: Determine qué campos de usuario desea recuperar

Si hace clic en el botón “Send” después del paso tres, recibirá en su respuesta los campos predeterminados del objeto de usuario: id, name y username.

Si desea recibir campos adicionales más allá de id, name y username, deberá especificarlos en su solicitud con los parámetros fields y/o expansions.

Para este ejercicio, solicitaremos tres conjuntos adicionales de campos de distintos objetos:

1. El campo adicional user.created_at en los objetos de usuario principales.

2. Los campos predeterminados del objeto de Posts fijados asociados para los usuarios devueltos: id y text.

3. El campo adicional tweet.created_at en los objetos Post asociados.

En Postman, vaya a la pestaña “Params” y agregue el siguiente par clave:valor a la tabla “Query Params”:

Key	Value	Returned fields
user.fields	created_at	user.created_at
expansions	pinned_tweet_id	includes.tweets.id, includes.tweets.text
tweet.fields	created_at, author_id	includes.tweets.created_at, includes_tweets.author_id

Ahora debería ver una URL similar junto al botón “Send”:

      https://api.x.com/2/users/me?user.fields=created_at&expansions=pinned_tweet_id&tweet.fields=author_id,created_at