集成指南

本页介绍在将 Lists 的 endpoint 集成到您的系统时需要了解的多种工具与关键概念。我们将内容分为以下几个部分：

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

​

实用工具

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

​

Postman

Postman 是一款非常适合用于测试 endpoint 的工具。每个 Postman 请求都包含所有路径参数和请求体参数，帮助您快速了解可用项。要了解更多关于我们的 Postman 集合的信息，请访问我们的 “Using Postman” 页面。 

​

代码示例

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

​

第三方库

利用我们的社区提供的第三方库来帮助您快速上手。您可以通过查看相应的版本标签，找到可与 v2 endpoint 配合使用的库。

​

核心概念

​

认证

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

这些特定的 endpoint 需要使用 OAuth 1.0a 用户上下文，也就是说，你必须使用一组 API 密钥和用户 Access Tokens 才能成功发起请求。Access Tokens 必须与你代表其发起请求的用户关联。如果你想为另一位用户生成一组 Access Tokens，他们必须通过 三方 OAuth 授权流程 授权或认证你的 App。

请注意，OAuth 1.0a 的使用可能较为复杂。如果你不熟悉这种认证方法，我们建议使用 library 或 Postman 等工具来正确完成请求认证。  

​

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

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

​

请求速率限制

每天有成千上万的开发者向 X API 发起请求。为管理如此庞大的请求量，我们在每个 endpoint 上施加了请求速率限制，以限制你代表你的 App 或经过身份验证的用户所能发起的请求数量。 

这些 endpoint 采用用户级别的请求速率限制，这意味着你所代表的经过身份验证的用户在任何开发者 App 中对该 endpoint 的调用次数都有上限。 

下表展示了各 endpoint 的请求速率限制。

Endpoint	HTTP 方法	请求速率限制
/2/lists	POST	每 15 分钟 300 次请求
/2/lists/:id	DELETE / PUT	每 15 分钟 300 次请求