Saltar al contenido principal

​
Introducción al endpoint de consulta de marcadores

Esta guía de inicio rápido le ayudará a realizar su primera solicitud al endpoint de consulta de marcadores con Postman. Visite nuestro repositorio de GitHub X API v2 sample code si desea ver ejemplos de código en distintos lenguajes.

​
Requisitos previos

Para completar esta guía, necesitarás un conjunto de claves y tokens para autenticar tu solicitud. Puedes generarlos siguiendo estos pasos:

​
Pasos para crear una solicitud de consulta de Bookmarks

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 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, vaya 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 token de acceso dentro de 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 como 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 client ID de OAuth 2.0 desde el Portal de desarrolladores. Client Secret - Copie y pegue el client secret de OAuth 2.0 desde el Portal de desarrolladores. Solo necesitará esto si está usando un tipo de App que sea un 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 ese usuario. Paso tres: especifique un usuario Con este endpoint, debe especificar el user ID cuyo contenido de Bookmarks desea consultar en la respuesta. Por ejemplo, el user ID de @XDevelopers es 2244994945. En Postman, vaya a la pestaña “Params” e ingrese su ID o el de un usuario autenticado como valor del parámetro id.
ClaveValor
id2244994945
Paso cuatro: envíe su solicitud y revise la respuesta Una vez que tenga todo configurado, presione el botón “Send” y recibirá una respuesta similar al siguiente ejemplo: 
{
   "data": [
       {
           "id": "1501258597237342208",
           "text": "🗣 ¿Has creado un proyecto con la X API que te gustaría compartir con la comunidad? Nos encantaría saber de ti. ¡Compártenos tu proyecto!"
       },
       {
           "id": "1501258542258348032",
           "text": "🧰🛠 Esta es solo una de las formas en que la innovación de los desarrolladores ayuda a que Twitter sea 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 que las ONG y las organizaciones sin fines de lucro desarrollen 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 mañana para continuar la conversación sobre la personalización de cronologías y cómo podría funcionar para los desarrolladores. Y mantente atento a más Spaces 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 creando herramientas para ayudar a conectar a las personas, mantenerlas seguras o compartir información con el mundo, estamos aquí para apoyarte: responde a este Tweet para contarnos más sobre tu App."
       }
   ]
}