社交账号的 REST API 端点
使用 REST API 管理已认证用户的社交账号。
关于社交账号管理
如果请求 URL 不包含{username}参数，则响应将针对已登录用户（并且您必须使用请求传递身份验证信息）。通过具有user作用域的 OAuth 进行身份验证时，将包含其他私人信息，例如用户是否启用了双因素身份验证。
列出已认证用户的社交账号
列出您所有的社交账号。
“列出已认证用户的社交账号”的细粒度访问令牌
此端点适用于以下细粒度令牌类型:
细粒度令牌不需要任何权限。
“列出已认证用户的社交账号”的参数
| 名称，类型，描述 |
|---|
accept 字符串建议设置为 |
| 名称，类型，描述 |
|---|
per_page 整数每页结果数（最大 100）。更多信息，请参阅“在 REST API 中使用分页”。 默认值： |
page 整数要获取的结果的页码。更多信息，请参阅“在 REST API 中使用分页”。 默认值： |
“列出已认证用户的社交账号”的 HTTP 响应状态代码
| 状态码 | 描述 |
|---|---|
200 | OK |
304 | 未修改 |
401 | 需要身份验证 |
403 | 禁止 |
404 | 资源未找到 |
“列出已认证用户的社交账号”的代码示例
请求示例
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/social_accounts响应
状态：200[ { "provider": "twitter", "url": "https://twitter.com/github" } ]为已认证用户添加社交账号
向已认证用户的个人资料添加一个或多个社交账号。
OAuth 应用令牌和个人访问令牌（经典版）需要user作用域才能使用此端点。
“为已认证用户添加社交账号”的细粒度访问令牌
此端点适用于以下细粒度令牌类型:
细粒度令牌必须具有以下权限集
- “个人资料”用户权限（写入）
“为已认证用户添加社交账号”的参数
| 名称，类型，描述 |
|---|
accept 字符串建议设置为 |
| 名称，类型，描述 |
|---|
account_urls 字符串数组 必需要添加的社交媒体个人资料的完整 URL。 |
“为已认证用户添加社交账号”的 HTTP 响应状态代码
| 状态码 | 描述 |
|---|---|
201 | 已创建 |
304 | 未修改 |
401 | 需要身份验证 |
403 | 禁止 |
404 | 资源未找到 |
422 | 验证失败，或端点已被滥用。 |
“为已认证用户添加社交账号”的代码示例
请求示例
curl -L \ -X POST \ -H "Accept: application/vnd.github+json" \ -H "Authorization: Bearer <YOUR-TOKEN>" \ -H "X-GitHub-Api-Version: 2022-11-28" \ https://api.github.com/user/social_accounts \ -d '{"account_urls":["https://facebook.com/GitHub","https://www.youtube.com/@GitHub"]}'响应
状态：201[ { "provider": "twitter", "url": "https://twitter.com/github" } ]删除已认证用户的社交账号
从已认证用户的个人资料中删除一个或多个社交账号。
OAuth 应用令牌和个人访问令牌（经典版）需要user作用域才能使用此端点。
“删除已认证用户的社交账号”的细粒度访问令牌
此端点适用于以下细粒度令牌类型:
细粒度令牌必须具有以下权限集
- “个人资料”用户权限（写入）
“删除已认证用户的社交账号”的参数
| 名称，类型，描述 |
|---|
accept 字符串建议设置为 |
| 名称，类型，描述 |
|---|
account_urls 字符串数组 必需要删除的社交媒体个人资料的完整 URL。 |
“删除已认证用户的社交账号”的 HTTP 响应状态代码
| 状态码 | 描述 |
|---|---|
204 | 无内容 |
304 | 未修改 |
401 | 需要身份验证 |
403 | 禁止 |
404 | 资源未找到 |
422 | 验证失败，或端点已被滥用。 |
“删除已认证用户的社交账号”的代码示例
请求示例
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/social_accounts \ -d '{"account_urls":["https://facebook.com/GitHub","https://www.youtube.com/@GitHub"]}'响应
状态：204列出用户的社交账号
列出用户的社交媒体账号。此端点可供任何人访问。
“列出用户的社交账号”的细粒度访问令牌
此端点适用于以下细粒度令牌类型:
细粒度令牌不需要任何权限。
如果仅请求公共资源，则可以使用此端点无需身份验证。
“列出用户的社交账号”的参数
| 名称，类型，描述 |
|---|
accept 字符串建议设置为 |
| 名称，类型，描述 |
|---|
username 字符串 必需GitHub 用户帐户的句柄。 |
| 名称，类型，描述 |
|---|
per_page 整数每页结果数（最大 100）。更多信息，请参阅“在 REST API 中使用分页”。 默认值： |
page 整数要获取的结果的页码。更多信息，请参阅“在 REST API 中使用分页”。 默认值： |
“列出用户的社交账号”的 HTTP 响应状态代码
| 状态码 | 描述 |
|---|---|
200 | OK |
“列出用户的社交账号”的代码示例
请求示例
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/social_accounts响应
状态：200[ { "provider": "twitter", "url": "https://twitter.com/github" } ]