搜索 Post（近期）

​

开始使用“近期 Post 计数”端点

本快速入门指南将帮助你使用 Postman（一个用于发送 HTTP 请求的图形化工具）向“近期 Post 计数”端点发出第一个请求。

如果你想查看不同编程语言的示例代码，请访问我们的 X API v2 sample code GitHub 代码库。

​

前提条件

要完成本指南，你需要一组用于请求认证的 keys and tokens。你可以按照以下步骤生成这些 keys 和 tokens：

• 注册开发者账户并通过审批。
• 在开发者门户中创建一个 Project 以及关联的开发者应用。
• 前往你的应用的“Keys and tokens”页面生成所需凭据。请确保将所有凭据妥善保存在安全位置。

​

构建“最近 Post 计数”请求的步骤

步骤一：选择工具或库

有多种工具、代码示例和库可用于向该端点发起请求，但为简化流程，这里我们使用 Postman。

要将 X API v2 的 Postman 集合加载到你的环境中，请点击以下按钮：

将 X API v2 添加到 Postman

在 Postman 中加载 X API v2 集合后，导航至 Post counts > Recent Post counts 请求。

步骤二：为请求进行认证

要正确调用 X API，需要验证访问权限。对于此端点，你必须使用 OAuth 2.0 App-Only 方法对请求进行认证。

你需要将密钥和令牌，尤其是 App Access Token（亦称 App-only Bearer Token）添加到 Postman。你可以在 Postman 右上角选择名为“X API v2”的环境，并将密钥与令牌填入 “initial value” 和 “current value” 字段（点击环境下拉菜单旁的“眼睛”图标）来完成。

如果设置正确，该变量会自动填充到请求的 Authorization 选项卡中。  

步骤三：创建查询

每个“最近 Post 计数”请求都需要一个query。本示例使用一个匹配 @XDevelopers 账号发布内容的查询。我们使用 from: 运算符，并将其设置为 XDevelopers（不区分大小写）：

from:XDevelopers

在 Postman 中，前往 “Params” 选项卡，将该查询或以逗号分隔的一串 Post ID 填入 query 参数的 “Value” 列中。

Key	Value	Description
query	from:XDevelopers	提交到“最近 Post 计数”端点的查询

步骤四（可选）：指定请求粒度

如果在步骤三后点击 “Send” 按钮，将返回默认的“最近 Post 计数”结果：过去 7 天按小时汇总。若需按天汇总，请添加 granularity 参数，值设为 day。

在 Postman 中，前往 “Params” 选项卡，在 granularity 参数的 “Value” 列中输入 day。

Key	Value	Description
granularity	day	Post 计数结果的粒度。可选值：day、hour、minute

你现在应当会在 “Send” 按钮旁看到以下 URL：

https://api.x.com/2/tweets/counts/recent?query=from%3AXDevelopers&granularity=day

步骤五：发送请求并查看响应

完成设置后，点击 “Send” 按钮，你将收到如下响应：

{
   "data": [
       {
           "end": "2021-06-16T00:00:00.000Z",
           "start": "2021-06-15T00:00:00.000Z",
           "tweet_count": 0
       },
       {
           "end": "2021-06-17T00:00:00.000Z",
           "start": "2021-06-16T00:00:00.000Z",
           "tweet_count": 1
       },
       {
           "end": "2021-06-18T00:00:00.000Z",
           "start": "2021-06-17T00:00:00.000Z",
           "tweet_count": 2
       },
       {
           "end": "2021-06-19T00:00:00.000Z",
           "start": "2021-06-18T00:00:00.000Z",
           "tweet_count": 0
       },
       {
           "end": "2021-06-20T00:00:00.000Z",
           "start": "2021-06-19T00:00:00.000Z",
           "tweet_count": 0
       },
       {
           "end": "2021-06-21T00:00:00.000Z",
           "start": "2021-06-20T00:00:00.000Z",
           "tweet_count": 0
       },
       {
           "end": "2021-06-22T00:00:00.000Z",
           "start": "2021-06-21T00:00:00.000Z",
           "tweet_count": 1
       },
       {
           "end": "2021-06-23T00:00:00.000Z",
           "start": "2021-06-22T00:00:00.000Z",
           "tweet_count": 2
       }
   ],
   "meta": {
       "total_tweet_count": 6
   }
}