Pontos de extremidade da API REST para autorizações de OAuth

Sobre OAuth apps e autorizações OAuth de GitHub Apps

Você pode usar esses pontos de extremidade para gerenciar os tokens OAuth que um OAuth apps ou GitHub Apps usa para acessar as contas das pessoas no GitHub.

Os tokens de OAuth apps têm o prefixo gho_, enquanto os tokens OAuth para GitHub Apps, usados para autenticação em nome do usuário, têm o prefixo ghu_. Você pode usar os pontos de extremidade a seguir para ambos os tipos de tokens 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.

Autenticação básica para “Delete an app authorization”

É necessário usar autenticação básica para usar este ponto de extremidade. Use o client_id do aplicativo como o nome de usuário e o client_secret como a senha.

Parâmetros para "Delete an app authorization"

Cabeçalhos
Nome, Tipo, Descrição
`accept` string Setting to `application/vnd.github+json` is recommended.

Parâmetros de caminho
Nome, Tipo, Descrição
`client_id` string Obrigatório The client ID of the GitHub app.

Parâmetros do corpo
Nome, Tipo, Descrição
`access_token` string Obrigatório The OAuth access token used to authenticate to the GitHub API.

Códigos de status de resposta HTTP para "Delete an app authorization"

Código de status	Descrição
`204`	No Content
`422`	Validation failed, or the endpoint has been spammed.

Exemplos de código para "Delete an app authorization"

If you access GitHub at GHE.com, replace api.github.com with your enterprise's dedicated subdomain at api.SUBDOMAIN.ghe.com.

Exemplo de solicitação

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" \
  https://api.github.com/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.

Autenticação básica para “Check a token”

É necessário usar autenticação básica para usar este ponto de extremidade. Use o client_id do aplicativo como o nome de usuário e o client_secret como a senha.

Parâmetros para "Check a token"

Cabeçalhos
Nome, Tipo, Descrição
`accept` string Setting to `application/vnd.github+json` is recommended.

Parâmetros de caminho
Nome, Tipo, Descrição
`client_id` string Obrigatório The client ID of the GitHub app.

Parâmetros do corpo
Nome, Tipo, Descrição
`access_token` string Obrigatório The access_token of the OAuth or GitHub application.

Códigos de status de resposta HTTP para "Check a token"

Código de status	Descrição
`200`	OK
`404`	Resource not found
`422`	Validation failed, or the endpoint has been spammed.

Exemplos de código para "Check a token"

If you access GitHub at GHE.com, replace api.github.com with your enterprise's dedicated subdomain at api.SUBDOMAIN.ghe.com.

Exemplo de solicitação

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" \
  https://api.github.com/applications/Iv1.8a61f9b3a7aba766/token \
  -d '{"access_token":"e72e16c7e42f292c6912e7710c838347ae178b4a"}'

Response

Status: 200

{
  "id": 1,
  "url": "https://api.github.com/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://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
  }
}

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.

Autenticação básica para “Reset a token”

É necessário usar autenticação básica para usar este ponto de extremidade. Use o client_id do aplicativo como o nome de usuário e o client_secret como a senha.

Parâmetros para "Reset a token"

Cabeçalhos
Nome, Tipo, Descrição
`accept` string Setting to `application/vnd.github+json` is recommended.

Parâmetros de caminho
Nome, Tipo, Descrição
`client_id` string Obrigatório The client ID of the GitHub app.

Parâmetros do corpo
Nome, Tipo, Descrição
`access_token` string Obrigatório The access_token of the OAuth or GitHub application.

Códigos de status de resposta HTTP para "Reset a token"

Código de status	Descrição
`200`	OK
`422`	Validation failed, or the endpoint has been spammed.

Exemplos de código para "Reset a token"

If you access GitHub at GHE.com, replace api.github.com with your enterprise's dedicated subdomain at api.SUBDOMAIN.ghe.com.

Exemplo de solicitação

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" \
  https://api.github.com/applications/Iv1.8a61f9b3a7aba766/token \
  -d '{"access_token":"e72e16c7e42f292c6912e7710c838347ae178b4a"}'

Response

Status: 200

{
  "id": 1,
  "url": "https://api.github.com/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://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
  }
}

Cabeçalhos
Nome, Tipo, Descrição
`accept` string Setting to `application/vnd.github+json` is recommended.

Parâmetros de caminho
Nome, Tipo, Descrição
`client_id` string Obrigatório The client ID of the GitHub app.

Parâmetros do corpo
Nome, Tipo, Descrição
`access_token` string Obrigatório The OAuth access token used to authenticate to the GitHub API.

Códigos de status de resposta HTTP para "Delete an app token"

Código de status	Descrição
`204`	No Content
`422`	Validation failed, or the endpoint has been spammed.

Exemplos de código para "Delete an app token"

If you access GitHub at GHE.com, replace api.github.com with your enterprise's dedicated subdomain at api.SUBDOMAIN.ghe.com.

Exemplo de solicitação

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" \
  https://api.github.com/applications/Iv1.8a61f9b3a7aba766/token \
  -d '{"access_token":"e72e16c7e42f292c6912e7710c838347ae178b4a"}'

Response

Status: 204

Pontos de extremidade da API REST para autorizações de OAuth

Sobre OAuth apps e autorizações OAuth de GitHub Apps

Delete an app authorization

Autenticação básica para “Delete an app authorization”

Parâmetros para "Delete an app authorization"

Códigos de status de resposta HTTP para "Delete an app authorization"

Exemplos de código para "Delete an app authorization"

Exemplo de solicitação

Response

Check a token

Autenticação básica para “Check a token”

Parâmetros para "Check a token"

Códigos de status de resposta HTTP para "Check a token"

Exemplos de código para "Check a token"

Exemplo de solicitação

Response

Reset a token

Autenticação básica para “Reset a token”

Parâmetros para "Reset a token"

Códigos de status de resposta HTTP para "Reset a token"

Exemplos de código para "Reset a token"

Exemplo de solicitação

Response

Delete an app token

Autenticação básica para “Delete an app token”

Parâmetros para "Delete an app token"

Códigos de status de resposta HTTP para "Delete an app token"

Exemplos de código para "Delete an app token"

Exemplo de solicitação

Response