跳转到主要内容

​
开始使用 hide replies endpoint

本快速上手指南将帮助你使用 Postman 向 hide replies endpoint 发出首个请求。 如果你想查看不同语言的代码片段，请访问 hide replies API Reference 页面。

​
先决条件

完成本指南，你需要一组用于对请求进行认证的密钥和令牌。你可以按照以下步骤生成这些密钥和令牌：
  • 注册开发者账户并获得审批。
  • 在开发者门户中创建一个 Project 及其关联的开发者 App。
  • 前往你的 App 的“Keys and tokens”页面生成所需凭证。请务必将所有凭证保存在安全位置。

​
构建 PUT /tweets/:id/hidden 请求的步骤

​
步骤一：从工具或库入手

有多种工具、代码示例和库可用于向此 endpoint 发送请求，但为简化流程，我们将在此使用 Postman。 要将 X API v2 的 Postman 集合加载到你的环境中，请点击以下按钮：
在你将 X API v2 集合加载到 Postman 后，导航到 hide replies endpoint。

​
步骤二：对请求进行身份验证

要正确地向 X API 发起请求，您需要确认自己具备相应权限。对于此 endpoint，您必须使用 OAuth 1.0a 用户上下文 或 OAuth 2.0 授权码模式（Authorization Code）配合 PKCE 来对请求进行身份验证。 在本示例中，我们将使用 OAuth 1.0a 用户上下文。 您必须将密钥和令牌——具体包括您的 API Key、API Secret Key、OAuth 1.0a 用户 access token 和 OAuth 1.0a 用户 Access Token Secret——添加到 Postman。您可以在 Postman 右上角选择名为“X API v2”的环境，并将您的密钥和令牌添加到“initial value”和“current value”字段中（点击环境下拉菜单旁的“眼睛”图标）。 如果您已正确完成上述操作，这些变量将自动填充到请求的 Authorization 选项卡中。  

​
第三步：查找要隐藏的 Post ID

hide replies endpoint 可以代表已授权用户隐藏或取消隐藏回复。由于本示例中使用的是与你的用户资料关联的 Access Tokens，你将能够隐藏参与你发起的对话的用户所发布的回复。同样，如果你使用的是属于另一位已授权你的 App 的用户的 Access Tokens，你也可以审核由该账户发起的任何对话中的回复。 请一位朋友回复一条 Post（提前告知对方你在测试隐藏回复），或使用测试账户回复你任意一条 Post。点击该回复，然后复制其 URL 中的数字部分。这就是我们将要隐藏的 Post ID。 在本例中，我们将查看以下 Post，其 ID 为 1232720193182412800： https://x.com/TwitterDev/status/1232720193182412800

​
步骤四：隐藏该 Post

在 Postman 中，打开 Hide replies 文件夹并选择 Hide a reply。在 Params 选项卡中，将 Post ID 粘贴到 id 字段旁边（无需替换 URL 中的 :id）。点击“Send”，即可看到成功的响应。 {"hidden":true}

​
步骤五：取消隐藏该 Post

被隐藏的 Posts 会移动到 X App 中的单独标签页。要在 Postman 中取消隐藏某条 Post，打开 Hide replies 文件夹并选择 Unhide a reply。在 Params 选项卡中，将上一步使用的相同 Post ID 粘贴到 id 字段。点击“Send”，即可看到成功的响应。 {"hidden":false} hidden 字段表示该 Post 的隐藏状态。隐藏状态为 true 表示该 Post 已被隐藏；为 false 则表示该 Post 未被隐藏。
⌘I