Saltar al contenido principal

​
Introducción a los endpoints para gestionar Bookmarks

Esta Guía rápida le ayudará a realizar su primera solicitud a los endpoints para gestionar Bookmarks usando Postman. Si desea ver Código de muestra en diferentes lenguajes, visite nuestro repositorio de X API v2 sample code en GitHub.
Requisitos previosPara completar esta guía, necesitará un conjunto de keys and tokens para autenticar su solicitud. Puede generar estas keys and tokens siguiendo estos pasos:

​
Pasos para crear una solicitud para administrar 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 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 “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 access token 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 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 ID desde el portal de desarrolladores. Solo necesitará esto si usa 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 de otra persona. 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 de usuario de @XDevelopers es 2244994945. En Postman, navegue a la pestaña “Params” e ingrese el id suyo o de un usuario autenticado como valor del parámetro id.
KeyValue
id2244994945
Paso cuatro: Especifique un Post que desea agregar a Bookmarks Vaya a la pestaña “Body” y asegúrese de que el ID de Post sea el que desea guardar en sus Bookmarks. La carga útil JSON debería verse similar a la siguiente. 
      {"tweet_id": "1460323737035677698"}
Paso cinco: realiza tu solicitud y revisa la respuesta Una vez que tengas todo configurado, haz clic en el botón “Send” y recibirás una respuesta similar al 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 del usuario 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 DELETE se complete correctamente, recibirás una respuesta similar al siguiente ejemplo: 
{
   "data": {
       "bookmarked": false
   }
}
⌘I