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