Skip to main content
설명서에 자주 업데이트를 게시하며 이 페이지의 번역이 계속 진행 중일 수 있습니다. 최신 정보는 영어 설명서를 참조하세요.
이제 REST API의 버전이 지정됩니다. 자세한 내용은 "API 버전 관리 정보"를 참조하세요.

소셜 계정

REST API를 사용하여 인증된 사용자의 소셜 계정을 관리합니다.

소셜 계정 관리 정보

요청 URL에 매개 변수가 {username} 포함되어 있지 않으면 로그인한 사용자에 대한 응답이 됩니다.{ % ifversion fpt or ghes or ghec %} 사용자가 2단계 인증을 사용할 수 있는지 여부와 같은 추가 개인 정보는 OAuth user 를 통해 인증될 때 범위에 포함됩니다.{ % endif %}

List social accounts for the authenticated user

Lists all of your social accounts.

"List social accounts for the authenticated user"에 대한 매개 변수

헤더
이름, 형식, Description
accept string

Setting to application/vnd.github+json is recommended.

쿼리 매개 변수
이름, 형식, Description
per_page integer

The number of results per page (max 100).

기본값: 30

page integer

Page number of the results to fetch.

기본값: 1

"List social accounts for the authenticated user"에 대한 HTTP 응답 상태 코드

상태 코드Description
200

OK

304

Not modified

401

Requires authentication

403

Forbidden

404

Resource not found

"List social accounts for the authenticated user"에 대한 코드 샘플

get/user/social_accounts
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

에서 작동 GitHub Apps

Add one or more social accounts to the authenticated user's profile. This endpoint is accessible with the user scope.

"Add social accounts for the authenticated user"에 대한 매개 변수

헤더
이름, 형식, Description
accept string

Setting to application/vnd.github+json is recommended.

본문 매개 변수
이름, 형식, Description
account_urls array of strings 필수

Full URLs for the social media profiles to add.

"Add social accounts for the authenticated user"에 대한 HTTP 응답 상태 코드

상태 코드Description
201

Created

304

Not modified

401

Requires authentication

403

Forbidden

404

Resource not found

422

Validation failed, or the endpoint has been spammed.

"Add social accounts for the authenticated user"에 대한 코드 샘플

post/user/social_accounts
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

에서 작동 GitHub Apps

Deletes one or more social accounts from the authenticated user's profile. This endpoint is accessible with the user scope.

"Delete social accounts for the authenticated user"에 대한 매개 변수

헤더
이름, 형식, Description
accept string

Setting to application/vnd.github+json is recommended.

본문 매개 변수
이름, 형식, Description
account_urls array of strings 필수

Full URLs for the social media profiles to delete.

"Delete social accounts for the authenticated user"에 대한 HTTP 응답 상태 코드

상태 코드Description
204

No Content

304

Not modified

401

Requires authentication

403

Forbidden

404

Resource not found

422

Validation failed, or the endpoint has been spammed.

"Delete social accounts for the authenticated user"에 대한 코드 샘플

delete/user/social_accounts
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

에서 작동 GitHub Apps

Lists social media accounts for a user. This endpoint is accessible by anyone.

"List social accounts for a user"에 대한 매개 변수

헤더
이름, 형식, Description
accept string

Setting to application/vnd.github+json is recommended.

경로 매개 변수
이름, 형식, Description
username string 필수

The handle for the GitHub user account.

쿼리 매개 변수
이름, 형식, Description
per_page integer

The number of results per page (max 100).

기본값: 30

page integer

Page number of the results to fetch.

기본값: 1

"List social accounts for a user"에 대한 HTTP 응답 상태 코드

상태 코드Description
200

OK

"List social accounts for a user"에 대한 코드 샘플

get/users/{username}/social_accounts
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" } ]