书签查找

​

开始使用 Bookmarks 查询端点

本快速入门指南将帮助你使用 Postman 向 Bookmarks 查询端点发出你的第一个请求。

如果你想查看不同语言的示例代码，请访问我们的 X API v2 示例代码 GitHub 仓库。

​

先决条件

要完成本指南，您需要一组用于对请求进行认证的keys and tokens。您可以按照以下步骤生成这些 keys 和 tokens：

• 注册开发者账户并通过审核。
• 在开发者门户中创建一个项目以及一个关联的开发者应用。
• 前往您的应用的“Keys and tokens”页面以生成所需的凭据。请务必将所有凭据妥善保存在安全位置。

​

构建 Bookmarks 查找请求的步骤

步骤一：选择工具或库

有多种工具、代码示例和库可用于向此端点发起请求，但为简化流程，我们将在此使用 Postman。

要将 X API v2 的 Postman 集合加载到你的环境，请点击以下按钮：

将 X API v2 添加到 Postman

在你将 X API v2 集合加载到 Postman 后，进入“Bookmarks”文件夹，选择“Bookmarks lookup”。

步骤二：为你的请求进行认证

要成功调用此端点，你需要使用 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.read

5. 将 state 字段填入“State”

6. 点击“Generate Token”

7. 点击保存图标以保存文件夹更改。

你可能会收到未登录 X 的提示。如果出现此错误，你需要在 Postman 中登录你要代表其发帖的 X 账号。

步骤三：指定用户

对于此端点，你必须指定要在响应中返回其数据的用户 ID。例如，@XDevelopers 的用户 ID 是 2244994945。在 Postman 中，进入“Params”选项卡，将你自己或已认证用户的 ID 填入 id 参数的值。

Key	Value
id	2244994945

步骤四：发起请求并检查响应

当一切就绪后，点击“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": "开发者创新始终很重要,包括在危机时期。如果您正在构建工具来帮助连接人们、保护他们的安全或与世界分享信息,我们会提供支持——回复此推文,告诉我们更多关于您应用的信息。"
       }
   ]
}