跳转到主要内容

​
使用管理书签的 endpoints 入门

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

​
构建管理 Bookmarks 请求的步骤

第一步：选择工具或库 有多种工具、代码示例和库可用于向此 endpoint 发起请求，但这里我们将使用 Postman 来简化流程。 要将 X API v2 的 Postman 集合加载到你的环境中，请点击以下按钮：
在 Postman 中加载 X API v2 集合后，前往“Bookmarks”文件夹，选择“Create a Bookmark”。 第二步：为请求进行身份验证 要成功调用此 endpoint，你需要使用 OAuth 2.0 Authorization Code Flow with PKCE。你可以在 Postman 中生成 access token。 前往名为“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。仅当你的 App 为机密客户端时需要此项。
  4. 将 scopes 设置为：post.read users.read bookmark.write
  5. 在 state 字段填入“State”
  6. 点击“Generate Token”
  7. 点击保存图标以保存文件夹更改。
你可能会收到提示尚未登录 X 的消息。如果出现此错误，需要在 Postman 中登录你要代其发帖的 X 账号。 第三步：指定用户 对于此 endpoint，必须指定要在响应中返回其关注者的用户 ID。例如，@XDevelopers 的用户 ID 为 2244994945。 在 Postman 中，前往“Params”选项卡，将你自己或已认证用户的 ID 作为 id 参数的值输入。
KeyValue
id2244994945
第四步：指定要加入书签的 Post 前往“Body”选项卡，确保将 Post ID 设置为你希望保存到 Bookmarks 的那条。JSON 负载应类似于下方示例。 
      {"tweet_id": "1460323737035677698"}
步骤五：发起请求并查看响应 完成所有设置后，点击“Send”按钮，您将收到与下方示例响应类似的结果： 
{
   "data": {
       "bookmarked": true
   }
}
要删除一条 Post，请在已加载到 Postman 的 X API v2 集合中，打开“Bookmarks”文件夹并选择“Remove a Bookmark”请求。首先，在“id”列中填写代表其发起请求的用户的用户 ID。此 endpoint 还需要你要删除的 Post 的 ID。然后在“Params”选项卡中，将要删除的 Post 的 ID 作为“tweet_id”列的值输入。  当你的 delete 请求成功时，你将收到类似以下示例的响应： 
{
   "data": {
       "bookmarked": false
   }
}
⌘I