Saltar al contenido principal

​
Introducción a los endpoints para gestionar Bookmarks

Esta guía de inicio rápido te ayudará a realizar tu primera solicitud a los endpoints para gestionar Bookmarks con Postman. Si deseas ver código de ejemplo en distintos lenguajes, visita nuestro repositorio de GitHub X API v2 sample code. 
Requisitos previosPara completar esta guía, necesitarás un conjunto de keys and tokens para autenticar tu solicitud. Puedes generarlos siguiendo estos pasos:

​
Pasos para crear una solicitud para administrar 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 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 cargada la colección de X API v2 en Postman, vaya a la carpeta “Bookmarks” y seleccione “Create a Bookmark”. 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 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 tipo de concesión 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á usando un tipo de App que sea un cliente confidencial.
  4. Actualice los scopes con los siguientes valores: post.read users.read bookmark.write
  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 del usuario. Paso tres: Especifique un usuario Con este endpoint, debe especificar el id de usuario cuyos seguidores desea recibir en la respuesta. Por ejemplo, el id de usuario de @XDevelopers es 2244994945. En Postman, vaya 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: Especifique un Post que desea agregar a Marcadores Vaya a la pestaña “Body” y asegúrese de que el Post ID esté configurado en el que desea guardar en sus Marcadores. La carga útil JSON debería verse similar a la siguiente. 
      {"tweet_id": "1460323737035677698"}
Paso cinco: Realiza tu solicitud y revisa tu respuesta Una vez que tengas todo configurado, haz clic en el botón “Send” y recibirás una respuesta similar a la del siguiente ejemplo: 
{
   "data": {
       "bookmarked": true
   }
}
Para eliminar un Post, selecciona la solicitud “Remove a Bookmark”, que también se encuentra en la carpeta “Bookmarks” de la colección de X API v2 cargada en Postman. Primero, especifica el ID de usuario de la persona en cuyo nombre realizas la solicitud como valor de la columna “id”. Este endpoint también requiere el ID del Post que deseas eliminar. Luego, en la pestaña “Params”, ingresa el ID del Post que deseas eliminar como valor de la columna “tweet_id”. Cuando la solicitud de eliminación se complete correctamente, recibirás una respuesta similar al siguiente ejemplo: 
{
   "data": {
       "bookmarked": false
   }
}