Skip to main content

Esta versão do GitHub Enterprise Server será descontinuada em 2026-08-25. Não há suporte para versões descontinuadas. Nenhum lançamento de patch será feito, mesmo para questões críticas de segurança. Para obter melhor desempenho, segurança aprimorada e novos recursos no GitHub Enterprise Server, consulte Overview do processo de atualização. Para obter ajuda com a atualização, entre em contato com o GitHub Enterprise Support.

Solução de erros de solicitação de token de acesso do aplicativo OAuth

Ao trocar um código para um token de acesso, há um conjunto adicional de erros que podem ocorrer. O formato dessas respostas é determinado pelo cabeçalho aceito que você passa.

Observação

Esses exemplos mostram apenas as respostas JSON.

Credenciais do cliente incorretas

Se a client_id e o client_secret que você transmitir estiverem incorretos, você receberá esta resposta de erro.

{
  "error": "incorrect_client_credentials",
  "error_description": "The client_id and/or client_secret passed are incorrect.",
  "error_uri": "/apps/managing-oauth-apps/troubleshooting-oauth-app-access-token-request-errors/#incorrect-client-credentials"
}

Para resolver esse erro, verifique se você tem as credenciais corretas para seu OAuth app. Verifique novamente client_id e client_secret para garantir que estejam corretos e sendo passados corretamente para GitHub.

Erro no redirecionamento do URI

Se você fornecer um redirect_uri que não corresponda ao que você registrou com o seu OAuth app, você receberá esta mensagem de erro:

{
  "error": "redirect_uri_mismatch",
  "error_description": "The redirect_uri MUST match the registered callback URL for this application.",
  "error_uri": "/apps/managing-oauth-apps/troubleshooting-authorization-request-errors/#redirect-uri-mismatch2"
}

Para corrigir este erro, forneça um redirect_uri que corresponda ao que você registrou ou deixe este parâmetro de fora para usar o padrão registrado com seu aplicativo.

Código de verificação incorreto

Se o código de verificação que você transmitiu estiver incorreto, estiver vencido ou não corresponder ao que você recebeu na primeira solicitação de autorização, você receberá este erro.

{
  "error": "bad_verification_code",
  "error_description": "The code passed is incorrect or expired.",
  "error_uri": "/apps/managing-oauth-apps/troubleshooting-oauth-app-access-token-request-errors/#bad-verification-code"
}

Para resolver esse erro, inicie o processo de autorização do OAuth novamente e obtenha um novo código.

Email de usuário não verificado

Se o usuário para o qual você está tentando gerar um token de acesso de usuário não tiver verificado seu endereço de e-mail principal com GitHub, você receberá este erro.

{
  "error": "unverified_user_email",
  "error_description": "The user must have a verified primary email.",
  "error_uri": "/apps/managing-oauth-apps/troubleshooting-oauth-app-access-token-request-errors/#unverified_user_email"
}

Para resolver esse erro, solicite ao usuário que verifique o endereço de email primário em sua GitHub conta. Para obter mais informações, consulte Verificar endereço de e-mail na GitHub Free documentação.