跳转到主要内容

​
开始使用管理书签（manage Bookmarks）端点

本快速入门指南将帮助你使用 Postman 向管理书签端点发出你的第一个请求。 如果你希望查看不同语言的示例代码，请访问我们的 X API v2 sample code GitHub 代码库。 
先决条件要完成本指南，你需要一组用于对请求进行认证的 keys and tokens。你可以按照以下步骤生成这些 keys 和 tokens：
  • 注册开发者账户 并通过审批。
  • 在开发者门户中创建一个 Project 以及关联的 developer App。
  • 前往你的应用的“Keys and tokens”页面生成所需的凭据。请务必将所有凭据保存在安全的位置。

​
构建“管理书签（Bookmarks）”请求的步骤

步骤一：选择工具或库 有多种工具、代码示例和库可用于向此端点发起请求。为简化流程，本文示例使用 Postman。 要将 X API v2 的 Postman 集合加载到您的环境，请点击以下按钮：
将 X API v2 集合加载到 Postman 后，前往“Bookmarks”文件夹，选择“Create a Bookmark”。 步骤二：为请求进行认证 要成功调用此端点，需使用 OAuth 2.0 Authorization Code Flow with PKCE。您可以在 Postman 内生成访问令牌。 前往名为“Authorization”的选项卡并选择“OAuth 2.0”。 在此选项卡中，请按以下步骤配置：
  1. 为令牌命名
  2. 将 Grant Type 设为 Authorization Code (with PKCE)
  3. 更新以下参数： Callback URL - https://www.example.com 该地址应与您在开发者门户中“认证”设置页面配置的回调 URL 完全一致。 Auth URL - https://x.com/i/oauth2/authorize Access Token URL - https://api.x.com/2/oauth2/token Client ID - 从开发者门户复制并粘贴 OAuth 2.0 client ID Client Secret - 从开发者门户复制并粘贴 OAuth 2.0 client secret。仅当您的应用属于机密客户端类型时需要。
  4. 将 scopes 设置为：post.read users.read bookmark.write
  5. 将 state 字段设置为“State”
  6. 点击“Generate Token”
  7. 点击保存图标以保存文件夹更改。
您可能会收到尚未登录 X 的提示。如出现该错误，请在 Postman 中登录要代表其发帖的 X 账号。 步骤三：指定用户 使用此端点时，必须指定希望在响应中接收其关注者列表的用户 ID。例如，@XDevelopers 的用户 ID 为 2244994945。 在 Postman 中，前往“Params”选项卡，将您自己或已认证用户的 ID 填入 id 参数的值。
KeyValue
id2244994945
步骤四：指定要加入书签的 Post 前往“Body”选项卡，确保 Post ID 设置为您希望保存到书签（Bookmarks）的那条 Post。JSON 负载应类似于下方示例。 
      {"tweet_id": "1460323737035677698"}
步骤五：发起请求并查看响应 完成所有设置后，点击“Send”按钮，你将收到与下方示例响应类似的结果： 
{
   "data": {
       "bookmarked": true
   }
}
要删除一条 Post，请在已加载到 Postman 的 X API v2 集合中，选择“Bookmarks”文件夹内的“Remove a Bookmark”请求。首先，将你代表其发起请求的用户的用户 ID 填入“id”列。此端点还需要你要删除的 Post 的 ID。然后，在“Params”选项卡中，将要删除的 Post 的 ID 填入“tweet_id”列。  当删除请求成功时，你将收到类似以下示例的响应： 
{
   "data": {
       "bookmarked": false
   }
}