OAuth 권한 부여에 대한 REST API 엔드포인트

OAuth apps 및 GitHub Apps의 OAuth 권한 부여 정보

이러한 엔드포인트를 사용하여 OAuth apps 또는 GitHub Apps을(를) 사용하는 OAuth 토큰을 관리하고 GitHub의 사용자 계정에 액세스할 수 있습니다.

OAuth apps에 대한 토큰에는 접두 사 gho_, 사용자를 대신하여 인증하는 데 사용되는 GitHub Apps에 대한 OAuth 토큰에는 접두 사 ghu_가 있습니다. 두 유형의 OAuth 토큰에 대해 다음 엔드포인트를 사용할 수 있습니다.

Delete an app authorization

OAuth and GitHub application owners can revoke a grant for their application and a specific user. You must provide a valid OAuth access_token as an input parameter and the grant for the token's owner will be deleted. Deleting an application's grant will also delete all OAuth tokens associated with the application for the user. Once deleted, the application will have no access to the user's account and will no longer be listed on the application authorizations settings screen within GitHub.

"Delete an app authorization"에 대한 기본 인증

엔드포인트를 사용하려면 기본 인증을 사용해야 합니다. 애플리케이션의 client_id을(를) 사용자 이름으로 사용하고 client_secret을(를) 암호로 사용합니다.

"Delete an app authorization"에 대한 매개 변수

머리글
속성, 형식, 설명
`accept` string Setting to `application/vnd.github+json` is recommended.

경로 매개 변수
속성, 형식, 설명
`client_id` string Required The client ID of the GitHub app.

본문 매개 변수
속성, 형식, 설명
`access_token` string Required The OAuth access token used to authenticate to the GitHub API.

"Delete an app authorization"에 대한 HTTP 응답 상태 코드

상태 코드	설명
`204`	No Content
`422`	Validation failed, or the endpoint has been spammed.

"Delete an app authorization"에 대한 코드 샘플

요청 예제

delete/applications/{client_id}/grant

curl -L \
  -X DELETE \
  -H "Accept: application/vnd.github+json" \
  -u "<YOUR_CLIENT_ID>:<YOUR_CLIENT_SECRET>" \
  -H "X-GitHub-Api-Version: 2022-11-28" \
  http(s)://HOSTNAME/api/v3/applications/Iv1.8a61f9b3a7aba766/grant \
  -d '{"access_token":"e72e16c7e42f292c6912e7710c838347ae178b4a"}'

Response

Status: 204

Check a token

OAuth applications and GitHub applications with OAuth authorizations can use this API method for checking OAuth token validity without exceeding the normal rate limits for failed login attempts. Authentication works differently with this particular endpoint. Invalid tokens will return 404 NOT FOUND.

"Check a token"에 대한 기본 인증

"Check a token"에 대한 매개 변수

머리글
속성, 형식, 설명
`accept` string Setting to `application/vnd.github+json` is recommended.

경로 매개 변수
속성, 형식, 설명
`client_id` string Required The client ID of the GitHub app.

본문 매개 변수
속성, 형식, 설명
`access_token` string Required The access_token of the OAuth or GitHub application.

"Check a token"에 대한 HTTP 응답 상태 코드

상태 코드	설명
`200`	OK
`404`	Resource not found
`422`	Validation failed, or the endpoint has been spammed.

"Check a token"에 대한 코드 샘플

요청 예제

post/applications/{client_id}/token

curl -L \
  -X POST \
  -H "Accept: application/vnd.github+json" \
  -u "<YOUR_CLIENT_ID>:<YOUR_CLIENT_SECRET>" \
  -H "X-GitHub-Api-Version: 2022-11-28" \
  http(s)://HOSTNAME/api/v3/applications/Iv1.8a61f9b3a7aba766/token \
  -d '{"access_token":"e72e16c7e42f292c6912e7710c838347ae178b4a"}'

Response

Status: 200

{
  "id": 1,
  "url": "https://HOSTNAME/authorizations/1",
  "scopes": [
    "public_repo",
    "user"
  ],
  "token": "ghu_16C7e42F292c6912E7710c838347Ae178B4a",
  "token_last_eight": "Ae178B4a",
  "hashed_token": "25f94a2a5c7fbaf499c665bc73d67c1c87e496da8985131633ee0a95819db2e8",
  "app": {
    "url": "http://my-github-app.com",
    "name": "my github app",
    "client_id": "Iv1.8a61f9b3a7aba766"
  },
  "note": "optional note",
  "note_url": "http://optional/note/url",
  "updated_at": "2011-09-06T20:39:23Z",
  "created_at": "2011-09-06T17:26:27Z",
  "fingerprint": "jklmnop12345678",
  "expires_at": "2011-09-08T17:26:27Z",
  "user": {
    "login": "octocat",
    "id": 1,
    "node_id": "MDQ6VXNlcjE=",
    "avatar_url": "https://github.com/images/error/octocat_happy.gif",
    "gravatar_id": "",
    "url": "https://HOSTNAME/users/octocat",
    "html_url": "https://github.com/octocat",
    "followers_url": "https://HOSTNAME/users/octocat/followers",
    "following_url": "https://HOSTNAME/users/octocat/following{/other_user}",
    "gists_url": "https://HOSTNAME/users/octocat/gists{/gist_id}",
    "starred_url": "https://HOSTNAME/users/octocat/starred{/owner}{/repo}",
    "subscriptions_url": "https://HOSTNAME/users/octocat/subscriptions",
    "organizations_url": "https://HOSTNAME/users/octocat/orgs",
    "repos_url": "https://HOSTNAME/users/octocat/repos",
    "events_url": "https://HOSTNAME/users/octocat/events{/privacy}",
    "received_events_url": "https://HOSTNAME/users/octocat/received_events",
    "type": "User",
    "site_admin": false
  }
}

Reset a token

OAuth applications and GitHub applications with OAuth authorizations can use this API method to reset a valid OAuth token without end-user involvement. Applications must save the "token" property in the response because changes take effect immediately. Invalid tokens will return 404 NOT FOUND.

"Reset a token"에 대한 기본 인증

"Reset a token"에 대한 매개 변수

머리글
속성, 형식, 설명
`accept` string Setting to `application/vnd.github+json` is recommended.

경로 매개 변수
속성, 형식, 설명
`client_id` string Required The client ID of the GitHub app.

본문 매개 변수
속성, 형식, 설명
`access_token` string Required The access_token of the OAuth or GitHub application.

"Reset a token"에 대한 HTTP 응답 상태 코드

상태 코드	설명
`200`	OK
`422`	Validation failed, or the endpoint has been spammed.

"Reset a token"에 대한 코드 샘플

요청 예제

patch/applications/{client_id}/token

curl -L \
  -X PATCH \
  -H "Accept: application/vnd.github+json" \
  -u "<YOUR_CLIENT_ID>:<YOUR_CLIENT_SECRET>" \
  -H "X-GitHub-Api-Version: 2022-11-28" \
  http(s)://HOSTNAME/api/v3/applications/Iv1.8a61f9b3a7aba766/token \
  -d '{"access_token":"e72e16c7e42f292c6912e7710c838347ae178b4a"}'

Response

Status: 200

{
  "id": 1,
  "url": "https://HOSTNAME/authorizations/1",
  "scopes": [
    "public_repo",
    "user"
  ],
  "token": "ghu_16C7e42F292c6912E7710c838347Ae178B4a",
  "token_last_eight": "Ae178B4a",
  "hashed_token": "25f94a2a5c7fbaf499c665bc73d67c1c87e496da8985131633ee0a95819db2e8",
  "app": {
    "url": "http://my-github-app.com",
    "name": "my github app",
    "client_id": "Iv1.8a61f9b3a7aba766"
  },
  "note": "optional note",
  "note_url": "http://optional/note/url",
  "updated_at": "2011-09-06T20:39:23Z",
  "created_at": "2011-09-06T17:26:27Z",
  "fingerprint": "jklmnop12345678",
  "expires_at": "2011-09-08T17:26:27Z",
  "user": {
    "login": "octocat",
    "id": 1,
    "node_id": "MDQ6VXNlcjE=",
    "avatar_url": "https://github.com/images/error/octocat_happy.gif",
    "gravatar_id": "",
    "url": "https://HOSTNAME/users/octocat",
    "html_url": "https://github.com/octocat",
    "followers_url": "https://HOSTNAME/users/octocat/followers",
    "following_url": "https://HOSTNAME/users/octocat/following{/other_user}",
    "gists_url": "https://HOSTNAME/users/octocat/gists{/gist_id}",
    "starred_url": "https://HOSTNAME/users/octocat/starred{/owner}{/repo}",
    "subscriptions_url": "https://HOSTNAME/users/octocat/subscriptions",
    "organizations_url": "https://HOSTNAME/users/octocat/orgs",
    "repos_url": "https://HOSTNAME/users/octocat/repos",
    "events_url": "https://HOSTNAME/users/octocat/events{/privacy}",
    "received_events_url": "https://HOSTNAME/users/octocat/received_events",
    "type": "User",
    "site_admin": false
  }
}

머리글
속성, 형식, 설명
`accept` string Setting to `application/vnd.github+json` is recommended.

경로 매개 변수
속성, 형식, 설명
`client_id` string Required The client ID of the GitHub app.

본문 매개 변수
속성, 형식, 설명
`access_token` string Required The OAuth access token used to authenticate to the GitHub API.

"Delete an app token"에 대한 HTTP 응답 상태 코드

상태 코드	설명
`204`	No Content
`422`	Validation failed, or the endpoint has been spammed.

"Delete an app token"에 대한 코드 샘플

요청 예제

delete/applications/{client_id}/token

curl -L \
  -X DELETE \
  -H "Accept: application/vnd.github+json" \
  -u "<YOUR_CLIENT_ID>:<YOUR_CLIENT_SECRET>" \
  -H "X-GitHub-Api-Version: 2022-11-28" \
  http(s)://HOSTNAME/api/v3/applications/Iv1.8a61f9b3a7aba766/token \
  -d '{"access_token":"e72e16c7e42f292c6912e7710c838347ae178b4a"}'

Response

Status: 204

OAuth apps 및 GitHub Apps의 OAuth 권한 부여 정보

Delete an app authorization

"Delete an app authorization"에 대한 기본 인증

"Delete an app authorization"에 대한 매개 변수

"Delete an app authorization"에 대한 HTTP 응답 상태 코드

"Delete an app authorization"에 대한 코드 샘플

요청 예제

Response

Check a token

"Check a token"에 대한 기본 인증

"Check a token"에 대한 매개 변수

"Check a token"에 대한 HTTP 응답 상태 코드

"Check a token"에 대한 코드 샘플

요청 예제

Response

Reset a token

"Reset a token"에 대한 기본 인증

"Reset a token"에 대한 매개 변수

"Reset a token"에 대한 HTTP 응답 상태 코드

"Reset a token"에 대한 코드 샘플

요청 예제

Response

Delete an app token

"Delete an app token"에 대한 기본 인증

"Delete an app token"에 대한 매개 변수

"Delete an app token"에 대한 HTTP 응답 상태 코드

"Delete an app token"에 대한 코드 샘플

요청 예제

Response