使用指南
集成指南
本页介绍在将管理 Bookmarks 端点集成到你的系统时需要了解的多种工具和关键概念。我们将本页分为以下几个部分：
在介绍有助于你集成该端点的一些关键概念之前，建议先熟悉以下内容：
Postman 是一款非常适合用于测试端点的工具。每个 Postman 请求都包含所有路径和请求体参数，帮助你快速了解可用内容。要进一步了解我们的 Postman 集合，请访问我们的「使用 Postman」页面：“Using Postman”。
想用你常用的编程语言配合一些代码来使用该端点吗？我们在 GitHub 页面提供了多种代码示例，供你作为起点参考。
利用我们社区提供的第三方库快速上手。你可以通过查看相应的版本标签来找到适用于 v2 端点的库。
所有 X API v2 端点都要求你使用一组凭证（也称为密钥和令牌）对请求进行认证。
以下特定端点需要使用 OAuth 2.0 授权码流程（含 PKCE）、以及 OAuth 2.0 授权码流程（含 PKCE），这意味着你必须使用一组密钥和用户访问令牌（Access Tokens）才能成功发起请求。访问令牌必须与所代表的目标用户关联。如果你想为另一位用户生成一组访问令牌，他们必须通过 Authorize URL、或 Authorize URL 授权或认证你的应用（App）。
请注意，OAuth 2.0 的使用可能较为复杂。如果你不熟悉这种认证方法，建议使用 第三方库、或 第三方库 或 Postman 等工具来正确完成请求的认证。
要获取可用于 X API v2 端点的一组认证凭据，您必须拥有一个开发者账户(中文)，在该账户中设置一个项目(中文)，并在该项目内创建一个开发者应用(中文)。随后，您可以在该开发者应用中找到自己的密钥和令牌。
每天都有成千上万的开发者向 X API 发起请求。为管理庞大的请求量，我们在每个端点上设置了速率限制，以限制你代表你的应用或已验证用户所能发起的请求数量。
这些端点在用户层面实施速率限制，这意味着你代表其发起请求的已验证用户在任何开发者应用中对该端点的调用次数都有上限。对于 GET 方法，用户速率限制为每 15 分钟 180 次请求。使用书签查询端点的 GET 方法，你将返回最近加书签的 800 条 Post。此外，POST 和 DELETE 方法的用户速率限制为每 15 分钟 50 次请求。