REST API 现在已分版本。 更多信息，请参阅“关于 API 版本控制”。

关注者的 REST API 端点

使用 REST API 获取有关已认证用户关注者的信息。

关于关注者管理

如果请求 URL 中不包含{username}参数，则响应将针对已登录用户（并且您必须使用请求传递身份验证信息）。当通过具有user作用域的 OAuth 进行身份验证时，将包含其他私人信息，例如用户是否启用了双因素身份验证。

列出已认证用户的关注者

列出关注已认证用户的用户。

“列出已认证用户的关注者”的细粒度访问令牌

此端点适用于以下细粒度令牌类型:

细粒度令牌必须具有以下权限集

  • “关注者”用户权限（读取）

“列出已认证用户的关注者”的参数

请求头
accept 字符串

建议设置为application/vnd.github+json。

查询参数
per_page 整数

每页结果数（最大 100）。更多信息，请参阅“在 REST API 中使用分页”。

默认值：30

page 整数

要获取的结果的页码。更多信息，请参阅“在 REST API 中使用分页”。

默认值：1

“列出已认证用户的关注者”的 HTTP 响应状态码

状态码描述
200

OK

304

未修改

401

需要身份验证

403

禁止

“列出已认证用户的关注者”的代码示例

请求示例

get/user/followers
curl -L \ -H "Accept: application/vnd.github+json" \ -H "Authorization: Bearer <YOUR-TOKEN>" \ -H "X-GitHub-Api-Version: 2022-11-28" \ https://api.github.com/user/followers

响应

状态：200
[ { "login": "octocat", "id": 1, "node_id": "MDQ6VXNlcjE=", "avatar_url": "https://github.com/images/error/octocat_happy.gif", "gravatar_id": "", "url": "https://api.github.com/users/octocat", "html_url": "https://github.com/octocat", "followers_url": "https://api.github.com/users/octocat/followers", "following_url": "https://api.github.com/users/octocat/following{/other_user}", "gists_url": "https://api.github.com/users/octocat/gists{/gist_id}", "starred_url": "https://api.github.com/users/octocat/starred{/owner}{/repo}", "subscriptions_url": "https://api.github.com/users/octocat/subscriptions", "organizations_url": "https://api.github.com/users/octocat/orgs", "repos_url": "https://api.github.com/users/octocat/repos", "events_url": "https://api.github.com/users/octocat/events{/privacy}", "received_events_url": "https://api.github.com/users/octocat/received_events", "type": "User", "site_admin": false } ]

列出已认证用户正在关注的人

列出已认证用户正在关注的人。

“列出已认证用户正在关注的人”的细粒度访问令牌

此端点适用于以下细粒度令牌类型:

细粒度令牌必须具有以下权限集

  • “关注者”用户权限（读取）

“列出已认证用户正在关注的人”的参数

请求头
accept 字符串

建议设置为application/vnd.github+json。

查询参数
per_page 整数

每页结果数（最大 100）。更多信息，请参阅“在 REST API 中使用分页”。

默认值：30

page 整数

要获取的结果的页码。更多信息，请参阅“在 REST API 中使用分页”。

默认值：1

“列出已认证用户正在关注的人”的 HTTP 响应状态码

状态码描述
200

OK

304

未修改

401

需要身份验证

403

禁止

“列出已认证用户正在关注的人”的代码示例

请求示例

get/user/following
curl -L \ -H "Accept: application/vnd.github+json" \ -H "Authorization: Bearer <YOUR-TOKEN>" \ -H "X-GitHub-Api-Version: 2022-11-28" \ https://api.github.com/user/following

响应

状态：200
[ { "login": "octocat", "id": 1, "node_id": "MDQ6VXNlcjE=", "avatar_url": "https://github.com/images/error/octocat_happy.gif", "gravatar_id": "", "url": "https://api.github.com/users/octocat", "html_url": "https://github.com/octocat", "followers_url": "https://api.github.com/users/octocat/followers", "following_url": "https://api.github.com/users/octocat/following{/other_user}", "gists_url": "https://api.github.com/users/octocat/gists{/gist_id}", "starred_url": "https://api.github.com/users/octocat/starred{/owner}{/repo}", "subscriptions_url": "https://api.github.com/users/octocat/subscriptions", "organizations_url": "https://api.github.com/users/octocat/orgs", "repos_url": "https://api.github.com/users/octocat/repos", "events_url": "https://api.github.com/users/octocat/events{/privacy}", "received_events_url": "https://api.github.com/users/octocat/received_events", "type": "User", "site_admin": false } ]

检查已认证用户是否关注某人

“检查已认证用户是否关注某人”的细粒度访问令牌

此端点适用于以下细粒度令牌类型:

细粒度令牌必须具有以下权限集

  • “关注者”用户权限（读取）

“检查已认证用户是否关注某人”的参数

请求头
accept 字符串

建议设置为application/vnd.github+json。

路径参数
username 字符串 必填

GitHub 用户帐户的用户名。

“检查已认证用户是否关注某人”的 HTTP 响应状态码

状态码描述
204

如果已认证用户关注此人

304

未修改

401

需要身份验证

403

禁止

404

如果已认证用户未关注此人

“检查已认证用户是否关注某人”的代码示例

请求示例

get/user/following/{username}
curl -L \ -H "Accept: application/vnd.github+json" \ -H "Authorization: Bearer <YOUR-TOKEN>" \ -H "X-GitHub-Api-Version: 2022-11-28" \ https://api.github.com/user/following/USERNAME

如果已认证用户关注此人

状态：204

关注用户

请注意，调用此端点时，您需要将Content-Length设置为零。更多信息，请参阅“HTTP 动词”。

OAuth 应用令牌和个人访问令牌（经典）需要user:follow作用域才能使用此端点。

“关注用户”的细粒度访问令牌

此端点适用于以下细粒度令牌类型:

细粒度令牌必须具有以下权限集

  • “关注者”用户权限（写入）

“关注用户”的参数

请求头
accept 字符串

建议设置为application/vnd.github+json。

路径参数
username 字符串 必填

GitHub 用户帐户的用户名。

“关注用户”的 HTTP 响应状态码

状态码描述
204

无内容

304

未修改

401

需要身份验证

403

禁止

404

资源未找到

422

验证失败，或端点已被滥用。

“关注用户”的代码示例

请求示例

put/user/following/{username}
curl -L \ -X PUT \ -H "Accept: application/vnd.github+json" \ -H "Authorization: Bearer <YOUR-TOKEN>" \ -H "X-GitHub-Api-Version: 2022-11-28" \ https://api.github.com/user/following/USERNAME

响应

状态：204

取消关注用户

OAuth 应用令牌和个人访问令牌（经典）需要user:follow作用域才能使用此端点。

“取消关注用户”的细粒度访问令牌

此端点适用于以下细粒度令牌类型:

细粒度令牌必须具有以下权限集

  • “关注者”用户权限（写入）

“取消关注用户”的参数

请求头
accept 字符串

建议设置为application/vnd.github+json。

路径参数
username 字符串 必填

GitHub 用户帐户的用户名。

“取消关注用户”的 HTTP 响应状态码

状态码描述
204

无内容

304

未修改

401

需要身份验证

403

禁止

404

资源未找到

“取消关注用户”代码示例

请求示例

delete/user/following/{username}
curl -L \ -X DELETE \ -H "Accept: application/vnd.github+json" \ -H "Authorization: Bearer <YOUR-TOKEN>" \ -H "X-GitHub-Api-Version: 2022-11-28" \ https://api.github.com/user/following/USERNAME

响应

状态：204

列出用户的关注者

列出关注指定用户的人。

“列出用户的关注者”的细粒度访问令牌

此端点适用于以下细粒度令牌类型:

细粒度令牌不需要任何权限。

如果只请求公共资源，则可以使用此端点无需身份验证。

“列出用户的关注者”的参数

请求头
accept 字符串

建议设置为application/vnd.github+json。

路径参数
username 字符串 必填

GitHub 用户帐户的用户名。

查询参数
per_page 整数

每页结果数（最大 100）。更多信息，请参阅“在 REST API 中使用分页”。

默认值：30

page 整数

要获取的结果的页码。更多信息，请参阅“在 REST API 中使用分页”。

默认值：1

“列出用户的关注者”的HTTP响应状态码

状态码描述
200

OK

“列出用户的关注者”代码示例

请求示例

get/users/{username}/followers
curl -L \ -H "Accept: application/vnd.github+json" \ -H "Authorization: Bearer <YOUR-TOKEN>" \ -H "X-GitHub-Api-Version: 2022-11-28" \ https://api.github.com/users/USERNAME/followers

响应

状态：200
[ { "login": "octocat", "id": 1, "node_id": "MDQ6VXNlcjE=", "avatar_url": "https://github.com/images/error/octocat_happy.gif", "gravatar_id": "", "url": "https://api.github.com/users/octocat", "html_url": "https://github.com/octocat", "followers_url": "https://api.github.com/users/octocat/followers", "following_url": "https://api.github.com/users/octocat/following{/other_user}", "gists_url": "https://api.github.com/users/octocat/gists{/gist_id}", "starred_url": "https://api.github.com/users/octocat/starred{/owner}{/repo}", "subscriptions_url": "https://api.github.com/users/octocat/subscriptions", "organizations_url": "https://api.github.com/users/octocat/orgs", "repos_url": "https://api.github.com/users/octocat/repos", "events_url": "https://api.github.com/users/octocat/events{/privacy}", "received_events_url": "https://api.github.com/users/octocat/received_events", "type": "User", "site_admin": false } ]

列出用户关注的人

列出指定用户关注的人。

“列出用户关注的人”的细粒度访问令牌

此端点适用于以下细粒度令牌类型:

细粒度令牌不需要任何权限。

如果只请求公共资源，则可以使用此端点无需身份验证。

“列出用户关注的人”的参数

请求头
accept 字符串

建议设置为application/vnd.github+json。

路径参数
username 字符串 必填

GitHub 用户帐户的用户名。

查询参数
per_page 整数

每页结果数（最大 100）。更多信息，请参阅“在 REST API 中使用分页”。

默认值：30

page 整数

要获取的结果的页码。更多信息，请参阅“在 REST API 中使用分页”。

默认值：1

“列出用户关注的人”的HTTP响应状态码

状态码描述
200

OK

“列出用户关注的人”代码示例

请求示例

get/users/{username}/following
curl -L \ -H "Accept: application/vnd.github+json" \ -H "Authorization: Bearer <YOUR-TOKEN>" \ -H "X-GitHub-Api-Version: 2022-11-28" \ https://api.github.com/users/USERNAME/following

响应

状态：200
[ { "login": "octocat", "id": 1, "node_id": "MDQ6VXNlcjE=", "avatar_url": "https://github.com/images/error/octocat_happy.gif", "gravatar_id": "", "url": "https://api.github.com/users/octocat", "html_url": "https://github.com/octocat", "followers_url": "https://api.github.com/users/octocat/followers", "following_url": "https://api.github.com/users/octocat/following{/other_user}", "gists_url": "https://api.github.com/users/octocat/gists{/gist_id}", "starred_url": "https://api.github.com/users/octocat/starred{/owner}{/repo}", "subscriptions_url": "https://api.github.com/users/octocat/subscriptions", "organizations_url": "https://api.github.com/users/octocat/orgs", "repos_url": "https://api.github.com/users/octocat/repos", "events_url": "https://api.github.com/users/octocat/events{/privacy}", "received_events_url": "https://api.github.com/users/octocat/received_events", "type": "User", "site_admin": false } ]

检查用户是否关注另一个用户

“检查用户是否关注另一个用户”的细粒度访问令牌

此端点适用于以下细粒度令牌类型:

细粒度令牌不需要任何权限。

如果只请求公共资源，则可以使用此端点无需身份验证。

“检查用户是否关注另一个用户”的参数

请求头
accept 字符串

建议设置为application/vnd.github+json。

路径参数
username 字符串 必填

GitHub 用户帐户的用户名。

target_user 字符串 必需

“检查用户是否关注另一个用户”的HTTP响应状态码

状态码描述
204

如果用户关注目标用户

404

如果用户没有关注目标用户

“检查用户是否关注另一个用户”代码示例

请求示例

get/users/{username}/following/{target_user}
curl -L \ -H "Accept: application/vnd.github+json" \ -H "Authorization: Bearer <YOUR-TOKEN>" \ -H "X-GitHub-Api-Version: 2022-11-28" \ https://api.github.com/users/USERNAME/following/TARGET_USER

如果用户关注目标用户

状态：204