快速入门

​

开始使用“管理关注关系”端点

本快速入门指南将帮助你使用 Postman 向“管理关注关系”端点发起第一条请求。

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

​

前提条件

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

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

​

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

​

步骤一：从工具或库着手

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

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

将 X API v2 添加到 Postman

在你将 X API v2 集合加载到 Postman 后，前往“Follows”文件夹，并选择“Follow a user ID”。  

​

步骤二：为请求进行认证

要正确向 X API 发起请求，你需要先确认自己具备相应的权限。对于此端点，你必须使用 OAuth 1.0a 用户上下文 或 OAuth 2.0 授权码（PKCE） 对请求进行认证。

在本示例中，我们将使用 OAuth 1.0a 用户上下文。

你需要将密钥和令牌——具体为 API Key、API Secret Key、OAuth 1.0a user Access Token，以及 OAuth 1.0a user Access Token Secret——添加到 Postman。你可以在 Postman 右上角选择名为“X API v2”的环境，并将密钥和令牌填入 “initial value” 和 “current value” 字段（点击环境下拉菜单旁的眼睛图标）。

如果操作正确，这些变量会自动带入请求的 authorization 选项卡。  

​

第三步：指定谁将关注谁

Manage follows 端点需要两个 ID：一个是源用户（希望关注或取消关注他人的用户），另一个是目标用户（将被关注或取消关注的用户）。源用户的 ID 必须与进行身份验证的用户的用户 ID 相对应。在本例中，你可以填写你自己的用户 ID。你可以通过两种方式找到你的 ID：

1. 使用 user lookup by username 端点，传入用户名即可返回 id 字段。
2. 查看你的 Access Token，其中的数字部分即为你的用户 ID。  

目标 ID 可以是任何有效的用户 ID。例如，@XDevelopers 的用户 ID 是 2244994945。

在 Postman 中，切换到“Params”选项卡，在 id 路径变量的“Value”列中输入你的 ID。然后切换到“Body”选项卡，将 2244994945（@XDevelopers 的用户 ID）作为 target_user_id 参数的值。请确保任何 ID 前后都不要包含空格。

Key	Value
id	（你的用户 ID）
target_user_id	2244994945

点击“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 参数应作为路径变量传递。