Saltar al contenido principal

​
Introducción al endpoint de búsqueda de marcadores

Esta guía rápida te ayudará a realizar tu primera solicitud al endpoint de búsqueda de marcadores con Postman. Visita nuestro repositorio de GitHub X API v2 sample code si deseas ver código de muestra en distintos lenguajes.

​
Requisitos previos

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

​
Pasos para crear una solicitud de búsqueda de marcadores

Paso uno: Comience con una herramienta o biblioteca Existen varias herramientas, ejemplos de código y bibliotecas que puede usar para realizar 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:
Una vez que tenga la colección de X API v2 cargada en Postman, navegue a la carpeta “Bookmarks” y seleccione “Bookmarks lookup”. Paso dos: Autentique su solicitud Para realizar una solicitud correcta a este endpoint, deberá usar OAuth 2.0 Authorization Code Flow with PKCE. Puede generar un access token en Postman.  Vaya a la pestaña “Authorization” y seleccione “OAuth 2.0”. En esta pestaña, asegúrese de seguir estos pasos:
  1. Asigne un nombre a su token.
  2. Seleccione el Grant Type “Authorization Code (with PKCE)”.
  3. Actualice los parámetros: Callback URL - https://www.example.com Debe coincidir con la URL de callback que configuró en la página de configuración de autenticación del portal de desarrolladores. Auth URL - https://x.com/i/oauth2/authorize Access Token URL - https://api.x.com/2/oauth2/token Client ID - Copie y pegue el OAuth 2.0 client ID desde el portal de desarrolladores. Client Secret - Copie y pegue el OAuth 2.0 client secret desde el portal de desarrolladores. Solo necesitará esto si está utilizando un tipo de App que sea cliente confidencial.
  4. Actualice los scopes con los siguientes valores: post.read users.read bookmark.read
  5. Rellene el campo state con “State”.
  6. Haga clic en “Generate Token”.
  7. Presione el ícono de guardar para guardar los cambios de la carpeta.
Es posible que reciba un mensaje indicando que no ha iniciado sesión en X. Si obtiene este error, deberá iniciar sesión en la cuenta de X dentro de Postman en la que intenta publicar en nombre de otro. Paso tres: Especifique un usuario Con este endpoint, debe especificar el id del usuario cuyos seguidores desea recibir en la respuesta. Por ejemplo, el id del usuario @XDevelopers es 2244994945. En Postman, navegue a la pestaña “Params” e ingrese el id suyo o de un usuario autenticado como valor para el parámetro id.
KeyValue
id2244994945
Paso cuatro: Realice su solicitud y revise su respuesta Una vez que tenga todo configurado, presione el botón “Send” y recibirá una respuesta similar a la del siguiente ejemplo: 
{
   "data": [
       {
           "id": "1501258597237342208",
           "text": "🗣 ¿Has desarrollado un proyecto usando la X API que te gustaría compartir con la comunidad? Nos encantaría conocer tu trabajo. ¡Compártelo con nosotros!"
       },
       {
           "id": "1501258542258348032",
           "text": "🧰🛠 Esta es solo una forma en que la innovación de los desarrolladores ayuda a hacer de Twitter un mejor lugar. Puedes encontrar otras herramientas listas para usar creadas por nuestra comunidad de desarrolladores en nuestro Twitter Toolbox aquí ⬇️ https://t.co/rK0X30JSYU"
       },
       {
           "id": "1501257716941000709",
           "text": "📣¡Hoy es un día importante! \nNos hemos asociado con @Jigsaw para el lanzamiento de esta nueva herramienta. Esta colaboración permite a las ONG y organizaciones sin fines de lucro desarrollar herramientas que ayuden a las personas a mantenerse seguras en Twitter, atendiendo las necesidades y preferencias de las comunidades a las que sirven. Más información ⬇️ https://t.co/MmznmgxoWT"
       },
       {
           "id": "1501686770810900485",
           "text": "Únete a nosotros mañana para continuar la conversación sobre la personalización de cronologías y cómo esto podría funcionar para los desarrolladores. Y mantente atento a más Spaces que tendremos la próxima semana. 👀 https://t.co/P4JTc14mdC"
       },
       {
           "id": "1501596763194593285",
           "text": "La innovación de los desarrolladores siempre es importante, incluso en tiempos de crisis. Si estás desarrollando herramientas para ayudar a conectar personas, mantenerlas seguras o compartir información con el mundo, estamos aquí para apoyarte—responde a este Tweet para contarnos más sobre tu aplicación."
       }
   ]
}
⌘I