集成指南

本页介绍了在将管理 Bookmarks 的 endpoint 集成到你的系统时应了解的多种工具和关键概念。我们将本页划分为若干部分：

• 实用工具
• 关键概念
  • 身份验证
  • 开发者门户、Project 和 App
  • 请求速率限制

​

实用工具

在介绍有助于你集成此 endpoint 的一些关键概念之前，建议先熟悉以下内容：

​

Postman

Postman 是一款非常适合用于测试 endpoint 的工具。每个 Postman 请求都包含所有路径参数和请求体参数，帮助你快速了解可用选项。要进一步了解我们的 Postman 集合，请访问我们的 「Using Postman」 页面。 

​

代码示例

想用您常用的编程语言配合一些代码来对接此 endpoint 吗？我们在 GitHub 页面提供了多种可作为起点的代码示例。

​

第三方库

利用我们社区提供的第三方库来快速入门。你可以通过查找相应的版本标签，找到适用于 v2 endpoint 的库。

​

核心概念

​

身份验证

所有 X API v2 endpoint 都要求你使用一组凭据（亦称“密钥和令牌”）对请求进行身份验证。 

以下这些特定的 endpoint 需要使用 OAuth 2.0 Authorization Code Flow with PKCE，也就是说，你必须使用一组密钥和用户 Access Tokens 才能成功发起请求。Access Tokens 必须与你代为发起请求的目标用户关联。如果你想为另一位用户生成一组 Access Tokens，则对方必须通过 Authorize URL 授权或验证你的 App。

请注意，OAuth 2.0 使用起来可能较为复杂。如果你不熟悉这种身份验证方式，我们建议使用一个 library 或者使用 Postman 等工具来正确地为你的请求进行身份验证。

​

开发者门户、Project 和开发者 App

要获取可用于 X API v2 endpoint 的一组身份验证凭证，您必须拥有一个开发者账户，在该账户中设置一个Project，并在该 Project 中创建一个开发者 App。随后，您可以在开发者 App 中找到您的密钥和令牌。 

​

请求速率限制

每天都有成千上万的开发者向 X API 发起请求。为应对如此庞大的请求量，我们在每个 endpoint 上设置了请求速率限制，以限制你代表你的 App 或代表已验证用户所能发起的请求数量。

这些 endpoint 采用用户级请求速率限制，这意味着你所代表的已验证用户在任何开发者 App 中对该 endpoint 的调用次数都有上限。对于 GET 方法，用户请求速率限制为每 15 分钟窗口 180 次。通过 Bookmarks lookup endpoint 的 GET 方法，你将会获得你最近的 800 条已加书签的 Post。此外，对于 POST 和 DELETE 方法，用户请求速率限制为每 15 分钟 50 次。