跳转到主要内容

​
使用 manage follows endpoint 入门

本快速上手指南将帮助你使用 Postman 向 manage follows endpoints 发送你的第一个请求。 如果你想查看不同语言的示例代码，请访问我们的 X API v2 sample code GitHub 仓库。

​
前提条件

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

​
构建“管理关注”请求的步骤

​
步骤一：选择工具或库

有多种工具、代码示例和库可用于向此 endpoint 发起请求，但为简化流程，我们将在此使用 Postman。 要将 X API v2 的 Postman 集合加载到您的环境中，请点击以下按钮：
在您将 X API v2 集合加载到 Postman 后，进入“Follows”文件夹，并选择“Follow a user ID”。  

​
第二步：为请求进行身份验证

要正确向 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 选项卡中。  

​
第三步：指定谁关注谁

Manage follows endpoint 需要两个 ID：一个是源用户（希望关注或取消关注他人的用户），另一个是目标用户（将被关注或取消关注的用户）。源用户的 ID 必须与进行身份验证的用户的用户 ID 匹配。在本例中，你可以指定你自己的用户 ID。你可以通过两种方式找到你的 ID：
  1. 使用 user lookup by username endpoint，你可以传入一个用户名并获取返回中的 id 字段。
  2. 查看你的 Access Token，其中的数字部分就是你的用户 ID。
目标 ID 可以是任意有效的用户 ID。例如，@XDevelopers 的用户 ID 是 2244994945。 在 Postman 中，转到“Params”选项卡，在 id 路径变量的“Value”列中输入你的 ID。然后转到“Body”选项卡，将 2244994945（@XDevelopers 的用户 ID）作为 target_user_id 参数的值。请确保任何 ID 前后都不要包含空格。
KeyValue
id（你的用户 ID）
target_user_id2244994945
点击“Send”按钮后，你将收到一个包含关系状态的响应对象：
  • 如果返回 “following”: true，则表示该 id 已成功关注 target_user_id。
  • 如果返回 “pending”: true，则表示 target_user_id 为受保护账号，必须接受你的关注请求。

​

步骤四：发起请求并检查响应 完成所有设置后，点击“Send”按钮，您将收到如下响应： 
    "data": {
        "following": true,
        "pending_follow": false
    }
}
同样，如果您要取消关注某个用户，请在同一 Postman 集合中使用“Unfollow a user ID”请求。不过，source_user_id 和 target_user_id 参数应作为路径变量在取消关注的 endpoint 中传递。
⌘I