跳转到主要内容

​
开始使用 Bookmarks 查询 endpoint

本快速上手指南将帮助你使用 Postman 向 Bookmarks 查询 endpoint 发起首次请求。 如果你想查看不同编程语言的示例代码，请访问我们的 X API v2 示例代码 GitHub 代码库。

​
先决条件

要完成本指南，您需要一组用于对请求进行身份验证的 keys and tokens。您可以按照以下步骤生成这些密钥和令牌：
  • 注册开发者账户并获得审批通过。
  • 在开发者门户中创建一个 Project 以及关联的 开发者 App。
  • 前往您的 App 的“Keys and tokens”页面以生成所需的凭据。请务必将所有凭据保存在安全的位置。

​
构建 Bookmarks 查询请求的步骤

步骤一：选择工具或库 有多种工具、代码示例和库可用于向此 endpoint 发起请求，但为简化流程，我们将在此使用 Postman。 要将 X API v2 的 Postman 集合加载到您的环境中，请点击以下按钮：
在 Postman 中加载 X API v2 集合后，导航到“Bookmarks”文件夹，并选择“Bookmarks lookup”。 步骤二：为请求进行认证 要成功调用此 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 ID。仅当您的 App 类型为“机密客户端”时需要。
  4. 将 scopes 更新为：post.read users.read bookmark.read
  5. 将 state 字段填写为“State”
  6. 点击“Generate Token”
  7. 点击保存图标以保存文件夹更改。
您可能会收到尚未登录 X 的提示。如果出现该错误，需要在 Postman 中登录要代表其发起请求的 X 账户。 步骤三：指定用户 使用此 endpoint 时，必须指定希望在响应中返回其关注者的用户 ID。例如，@XDevelopers 的用户 ID 是 2244994945。在 Postman 中，进入“Params”选项卡，将您自己或某已认证用户的 ID 填入 id 参数的值。
KeyValue
id2244994945
步骤四：发起请求并查看响应 完成所有设置后，点击“Send”按钮，您将收到与以下示例响应类似的结果： 
{
   "data": [
       {
           "id": "1501258597237342208",
           "text": "🗣 您是否使用 X API 构建了想要与社区分享的项目？我们很想了解您的项目。请与我们分享！"
       },
       {
           "id": "1501258542258348032",
           "text": "🧰🛠 这只是开发者创新帮助让 Twitter 变得更好的一种方式。您可以在我们的 Twitter 工具箱中找到由我们开发者社区构建的其他现成工具 ⬇️ https://t.co/rK0X30JSYU"
       },
       {
           "id": "1501257716941000709",
           "text": "📣今天是重要的一天！\n我们与 @Jigsaw 合作推出了这个新工具。这种合作使非政府组织和非营利组织能够构建工具，通过满足其所服务社区的需求和偏好来帮助人们在 Twitter 上保持安全。了解更多 ⬇️ https://t.co/MmznmgxoWT"
       },
       {
           "id": "1501686770810900485",
           "text": "明天请加入我们，继续讨论自定义时间线以及这对开发者可能意味着什么。请继续关注下周即将举行的更多 Spaces。👀 https://t.co/P4JTc14mdC"
       },
       {
           "id": "1501596763194593285",
           "text": "开发者创新始终很重要，包括在危机时期。如果您正在构建工具来帮助连接人们、保护他们的安全或与世界分享信息，我们会在这里提供支持——请回复此 Tweet 告诉我们更多关于您的应用的信息。"
       }
   ]
}
⌘I