Publicamos atualizações frequentes em nossa documentação, e a tradução desta página ainda pode estar em andamento. Para obter as informações mais recentes, acesse a documentação em inglês. Se houver problemas com a tradução desta página, entre em contato conosco.

Solução de Problemas

Aprenda a resolver os problemas mais comuns que as pessoas enfrentam na API REST.

Neste artigo

Se você estiver encontrando algumas situações estranhas na API, aqui está uma lista de resoluções de alguns dos problemas que você pode estar enfrentando.

Erro 404 para um repositório existente

Normalmente, enviamos um erro 404 quando seu cliente não está autenticado corretamente. Nesses casos, você pode esperar ver um 403 Forbidden. No entanto, como não queremos fornecer nenhuma informação sobre repositórios privados, a API retorna um erro 404.

Para solucionar o problema, verifique se você está efetuando a autenticação corretamente, se seu token de acesso do OAuth tem os escopos necessários e se as restrições de aplicativos de terceiros não estão bloqueando o acesso.

Nem todos os resultados retornados

A maioria das chamadas da API que acessam uma lista de recursos (por exemplo,, usuários, issues, etc.) é compatível com a paginação. Se você está fazendo solicitações e recebendo um conjunto incompleto de resultados, provavelmente você só está vendo a primeira página. Você precisará solicitar as páginas restantes para obter mais resultados.

É importante não tentar adivinhar o formato da URL de paginação. Nem todas as chamadas de API usam a mesma estrutura. Em vez disso, extraia as informações de paginação do Cabeçalho do link, que é enviado com cada solicitação.

Erros de autenticação básica

Em 13 de novembro de 2020 a autenticação de nome de usuário e senha da API REST e da API de Autorizações OAuth tornaram-se obsoletas e já não funcionaram mais.

Usar nome de usuário/senha para autenticação básica

Se você estiver usando um nome de usuário e senha para chamadas de API, eles não são conseguirão mais efetuar a autenticação. Por exemplo:

curl -u my_user:my_password https://api.github.com/user/repos

Em vez disso, use um token de acesso pessoal ao testar pontos de extremidade ou fazer desenvolvimento local:

curl -H 'Authorization: token my_access_token' https://api.github.com/user/repos

Para aplicativos OAuth, você deve usar o fluxo de aplicativo web para gerar um token do OAuth para usar no cabeçalho da chamada da API:

curl -H 'Authorization: token my-oauth-token' https://api.github.com/user/repos

Chamadas para API de autorização do OAuth

Se você estiver fazendo chamadas de API de autorização do OAuth para gerenciar as autorizações do seu aplicativo OAuth ou para gerar tokens de acesso de forma similar a este exemplo:

curl -u my_username:my_password -X POST "https://api.github.com/authorizations" -d '{"scopes":["public_repo"], "note":"my token", "client_id":"my_client_id", "client_secret":"my_client_secret"}'

Você deverá alternar para o fluxo do aplicativo web para gerar tokens de acesso.

Esse documento ajudou você?

Privacy policy

Ajude-nos a tornar esses documentos ótimos!

Todos os documentos do GitHub são de código aberto. Você percebeu que algo que está errado ou não está claro? Envie um pull request.

Faça uma contribuição

Ou, aprenda como contribuir.