Cuentas sociales
Usa la API de REST para administrar las cuentas de red social de los usuarios autenticados.
Acerca de la administración de cuentas de red social
Si una URL de solicitud no incluye un parámetro {username}
, la respuesta será para el usuario que ha iniciado sesión (y debes pasar la información de autenticación con tu solicitud). La información privada adicional como, por ejemplo, si un usuario tiene habilitada la autenticación en dos fases, se incluye cuando se autentica con la OAuth, con el ámbito de user
.
List social accounts for the authenticated user
Lists all of your social accounts.
Parámetros para "List social accounts for the authenticated user"
Encabezados |
---|
Nombre, Tipo, Descripción |
accept string Setting to |
Parámetros de consulta |
Nombre, Tipo, Descripción |
per_page integer The number of results per page (max 100). Valor predeterminado: |
page integer Page number of the results to fetch. Valor predeterminado: |
Códigos de estado de respuesta HTTP para "List social accounts for the authenticated user"
status code | Descripción |
---|---|
200 | OK |
304 | Not modified |
401 | Requires authentication |
403 | Forbidden |
404 | Resource not found |
Ejemplos de código para "List social accounts for the authenticated 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/user/social_accounts
Response
Status: 200
[
{
"provider": "twitter",
"url": "https://twitter.com/github"
}
]
Add social accounts for the authenticated user
Add one or more social accounts to the authenticated user's profile. This endpoint is accessible with the user
scope.
Parámetros para "Add social accounts for the authenticated user"
Encabezados |
---|
Nombre, Tipo, Descripción |
accept string Setting to |
Parámetros del cuerpo |
Nombre, Tipo, Descripción |
account_urls array of strings RequeridoFull URLs for the social media profiles to add. |
Códigos de estado de respuesta HTTP para "Add social accounts for the authenticated user"
status code | Descripción |
---|---|
201 | Created |
304 | Not modified |
401 | Requires authentication |
403 | Forbidden |
404 | Resource not found |
422 | Validation failed, or the endpoint has been spammed. |
Ejemplos de código para "Add social accounts for the authenticated user"
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"]}'
Response
Status: 201
[
{
"provider": "twitter",
"url": "https://twitter.com/github"
}
]
Delete social accounts for the authenticated user
Deletes one or more social accounts from the authenticated user's profile. This endpoint is accessible with the user
scope.
Parámetros para "Delete social accounts for the authenticated user"
Encabezados |
---|
Nombre, Tipo, Descripción |
accept string Setting to |
Parámetros del cuerpo |
Nombre, Tipo, Descripción |
account_urls array of strings RequeridoFull URLs for the social media profiles to delete. |
Códigos de estado de respuesta HTTP para "Delete social accounts for the authenticated user"
status code | Descripción |
---|---|
204 | No Content |
304 | Not modified |
401 | Requires authentication |
403 | Forbidden |
404 | Resource not found |
422 | Validation failed, or the endpoint has been spammed. |
Ejemplos de código para "Delete social accounts for the authenticated user"
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"]}'
Response
Status: 204
List social accounts for a user
Lists social media accounts for a user. This endpoint is accessible by anyone.
Parámetros para "List social accounts for a user"
Encabezados |
---|
Nombre, Tipo, Descripción |
accept string Setting to |
Parámetros de la ruta de acceso |
Nombre, Tipo, Descripción |
username string RequeridoThe handle for the GitHub user account. |
Parámetros de consulta |
Nombre, Tipo, Descripción |
per_page integer The number of results per page (max 100). Valor predeterminado: |
page integer Page number of the results to fetch. Valor predeterminado: |
Códigos de estado de respuesta HTTP para "List social accounts for a user"
status code | Descripción |
---|---|
200 | OK |
Ejemplos de código para "List social accounts for a 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/social_accounts
Response
Status: 200
[
{
"provider": "twitter",
"url": "https://twitter.com/github"
}
]