Guía rápida

​

Introducción al uso del endpoint de búsqueda de Spaces

Esta guía de inicio rápido le ayudará a realizar su primera solicitud al endpoint de búsqueda de Spaces con un conjunto de fields especificados usando Postman.

Si desea ver código de ejemplo en distintos lenguajes de programación, visite nuestro repositorio de GitHub con código de ejemplo de X API v2.

Requisitos previos

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

• Regístrese para obtener una cuenta de desarrollador y reciba 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 de Spaces

Paso uno: Comience con una herramienta o biblioteca

Hay varias herramientas, ejemplos de código y bibliotecas que puede usar para hacer una solicitud a este endpoint, pero aquí usaremos la herramienta Postman para simplificar el proceso.

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

Agregar X API v2 a Postman

Una vez que tenga la colección de X API v2 cargada en Postman, navegue a la carpeta Spaces y encuentre la solicitud “Search Spaces”.  

Paso dos: Autentique su solicitud

Para realizar correctamente una solicitud a la X API, debe verificar que tiene permiso. Para hacerlo, este endpoint requiere que autentique su solicitud con OAuth 2.0 App-Only o Código de autorización de OAuth 2.0 con PKCE.

Para simplificar, usaremos OAuth 2.0 App-Only con esta solicitud, pero deberá usar uno de los otros métodos de Autenticación si desea solicitar métricas privadas o Spaces de un usuario privado. 

Para utilizar OAuth 2.0 App-Only, debe agregar sus claves y tokens, específicamente el App Access Token (también conocido como el App-only Bearer Token) a Postman. Puede hacerlo seleccionando el entorno denominado “X API v2” en la esquina superior derecha de Postman y agregando sus claves y tokens en los campos “initial value” y “current value” (haciendo clic en el ícono de ojo junto al menú desplegable del entorno).

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

Paso tres: Cree una consulta de búsqueda

Este endpoint acepta texto como consulta de búsqueda. A diferencia de otros endpoints de búsqueda, no acepta operadores, agrupación ni operadores lógicos. Para este ejercicio, usaremos “hello” como una consulta simple.

En Postman, navegue a la pestaña “Params” e ingrese este id de usuario en la columna “Value” del parámetro id.

Key	Value
query	hello

Paso cuatro: Identifique y especifique qué fields le gustaría recuperar

Si hace clic en el botón “Send” después del paso tres, recibirá el id de los Spaces y su estado, que son los únicos fields del objeto Space que se devuelven de forma predeterminada en su respuesta.

Si desea recibir fields adicionales, deberá especificarlos en su solicitud con los parámetros space.fields o expansions.

Para este ejercicio, solicitaremos tres conjuntos adicionales de fields de diferentes objetos:

• El field adicional title en el objeto Spaces principal.
• El objeto de usuario completo del creator id especificado
• El field adicional user.created_at en el objeto de usuario asociado.

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

Key	Value	Returned fields
space.fields	title	creator_id
expansions	creator_id	includes.users.id, includes.users.name, includes.users.username
user.fields	created_at	includes.users.created_at

Ahora debería ver la siguiente URL junto al botón “Send”:

https://api.x.com/2/spaces/search?query=hello&space.fields=creator_id&expansions=creator_id&user.fields=created_at

Paso cinco: Realice su solicitud y revise su respuesta

Una vez que tenga todo configurado, presione el botón “Send” y recibirá la siguiente respuesta:

   "data": [
    {
        "creator_id": "2244994945",
        "id": "1zqKVXPQhvZJB",
        "title": "Hola mundo 👋",
        "state": "En ejecución"
   },
   "includes": {
       "users": [
           {
               "created_at": "2013-12-14T04:35:55.000Z",
               "name": "Twitter Dev",
               "id": "2244994945",
               "username": "TwitterDev"
           }
       ]
   }
]
}