跳转到主要内容

​
开始使用隐藏回复端点

本快速入门指南将帮助你使用 Postman 向隐藏回复端点发出你的第一个请求。 如果你想查看不同语言的代码示例，请访问 隐藏回复 API 参考页面。 

​
先决条件

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

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

​
第一步：选择一个工具或库

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

​
第二步：对请求进行认证

要正确地向 X API 发起请求，您需要先确认自己具备相应权限。对于此端点，您必须使用 OAuth 1.0a 用户上下文 或 OAuth 2.0 授权码（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

“隐藏回复”端点可代表已授权用户隐藏或取消隐藏回复。由于本示例使用与你的用户资料关联的访问令牌（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

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