集成指南
概览
本页介绍在将“近期”或“完整归档”的 Post 计数 endpoint 集成到你的系统时需要了解的多种工具和关键概念。我们将本页分为以下部分：
在开始探讨一些关键概念之前，我们建议你先使用以下任一工具或代码示例来测试这些 endpoint 的功能。
想用你常用的编程语言，通过代码快速接入这些 endpoint 吗？我们在 GitHub 页面提供了多种代码示例，可作为起点使用，其中包括一个 Python 客户端。
利用我们的社区第三方库来帮助你快速上手。通过查找相应的版本标签，你可以找到适用于 v2 endpoint 的库。
Postman 是一款非常出色的工具，可用于测试这些 endpoint。每个 Postman 请求都包含该 endpoint 的所有参数，帮助你快速了解可用项。要进一步了解我们的 Postman 集合，请访问使用 Postman页面。
所有 X API v2 endpoint 都要求使用一组凭据（也称为密钥和令牌）对请求进行身份验证。此特定 endpoint 需要使用 OAuth 2.0 Bearer Token，也就是说，你必须在请求中传递一个 Bearer Token 才能请求成功。你可以直接在开发者 App 中生成 Bearer Token，或使用 POST oauth2/token endpoint 生成。
要使用任何 X API v2 的 endpoint，你必须拥有一个开发者账户，在该账户下设置一个Project，并在该 Project 内创建一个开发者 App。该开发者 App 中的密钥和令牌可用于近期 Post 计数的 endpoint。若你希望使用全量归档 Post 计数的 endpoint，或使用高级运算符和更长的 query（查询）长度，则需要获得 Enterprise 访问批准。
请访问我们的 Enterprise 访问部分以了解更多信息。
每天都有成千上万的开发者向 X API 发起请求。为便于管理请求量，请求速率限制 会应用到每个 endpoint，上限约束开发者代表某个 App 或经过身份验证的用户所能发起的请求次数。
此 endpoint 采用 App 级别的请求速率限制，这意味着作为开发者的你，在任意给定的时间窗口内，从任意一个 App（由你所使用的凭证所标识）对该 endpoint 只能发起有限次数的请求。
这些 endpoint 的核心特性在于使用单个 query 将 Posts 过滤成返回给你的计数。查询由用于匹配 Post 和用户属性的运算符组成，例如消息关键词、话题标签（hashtag）和 URL。你可以使用布尔逻辑和括号将运算符组合成 query，以进一步细化匹配行为。
你可以参考我们的指南如何构建查询了解更多。
针对最近的 Post 计数，接口不会返回 next_token。这意味着无论粒度如何，您都可以通过一次 API 调用获取过去 7 天的 Post 数量。
针对全量归档的 Post 计数，您将获得过去 30 天的数据。对于超过 30 天之前的数据，响应会返回一个 next_token，您可以使用该值进行分页以获取更多数据。
用于 Post 计数的 endpoints 接受一个通过 GET 请求提交的单个 query，并返回与该 query 匹配的一组历史 Post 计数。query 由用于匹配多种 Post 属性的运算符组成。
⌘I