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.

Criar um aplicativo GitHub

Você pode criar e registrar um aplicativo GitHub na sua conta pessoal em sob qualquer organização à qual você tem acesso administrativo.

Para aprender como usar Manifestos do aplicativo GitHub, que permite às pessoas criar aplicativos GitHub pré-configurados, consulte "Criar aplicativos GitHub a partir de um manifesto.

Observação: Um usuário ou organização pode ter até 100 aplicativos GitHub.

  1. No canto superior direito de qualquer página, clique na sua foto de perfil e, em seguida, clique em Configurações.

    Ícone Settings (Configurações) na barra de usuário

  2. Na barra lateral esquerda, clique em Developer settings (Configurações do desenvolvedor).

    Seção de configurações do desenvolvedor

  3. Na barra lateral esquerda, clique em Aplicativos GitHub.

    Seção de aplicativos do GitHub

  4. Clique em Novo aplicativo GitHub.

    Botão para criar um novo aplicativo GitHub

  5. Em "Nome do aplicativo GitHub App", digite o nome do seu aplicativo.

    Campo para o nome do seu aplicativo GitHub

    Dê um nome claro e sucinto ao seu aplicativo. Seu aplicativo não pode ter o mesmo nome de um usuário existente no GitHub, a menos que seja o seu próprio nome de usuário ou da sua organização. Uma versão movida do nome do seu aplicativo será exibida na interface do usuário quando sua integração realizar uma ação.

  6. Opcionalmente, em "Descrição", digite uma descrição do aplicativo que os usuários irão ver.

    Campo para uma descrição do seu aplicativo GitHub

  7. Em "URL da página inicial", digite a URL completa do site do seu aplicativo.

    Campo para a URL da página inicial do seu aplicativo GitHub

  8. In "Callback URL", type the full URL to redirect to after a user authorizes the installation. Esta URL é usada se o aplicativo precisar identificar e autorizar solicitações de usuário para servidor.

    You can use Add callback URL to provide additional callback URLs, up to a maximum of 10.

    Button for 'Add callback URL' and field for callback URL

  9. Por padrão, para melhorar a segurança de seus aplicativos, seus aplicativos usarão os tokens de autorização do usuário. Para optar por não usar tokens do usuário expirados, você deverá desmarcar "Expirar tokens de autorização do usuário". Para saber mais sobre como configurar o fluxo de atualização do token e os benefícios de expirar os tokens do usuário, consulte "Atualizando tokens de acesso do usuário para o servidor."

    Opção para expirar os tokens dos usuários durante a configuração dos aplicativos GitHub

  10. Se seu aplicativo autoriza usuários a usar o fluxo OAuth, você pode selecionar Solicitar autorização de usuário (OAuth) durante a instalação para permitir que pessoas autorizem o aplicativo ao instalá-lo, economizando uma etapa. Se você selecionar esta opção, a "URL de configuração" irá tornar-se indisponível e os usuários serão redirecionados para a "URL de retorno de chamada de autorização do usuário" após a instalação do aplicativo. Consulte "Autorizando usuários durante a instalação" para obter mais informações.

    Solicitar autorização de usuário durante a instalação

  11. Se for necessária uma configuração adicional após a instalação, adicione um "Configurar URL" para redirecionar os usuários após a instalação do seu aplicativo.

    Campo para a URL de configuração do seu aplicativo GitHub

    Observação: Ao selecionar Solicitar autorização do usuário (OAuth) durante a instalação na etapa anterior, este campo irá tornar-se indisponível e as pessoas serão redirecionadas para a "URL de chamada de retorno de autorização do usuário" após a instalação do aplicativo.

  12. Na "URL Webhook", digite a URL para a qual os eventos serão POST. Cada aplicativo recebe o seu próprio webhook, que irá notificá-lo sempre que o aplicativo for instalado ou modificado, bem como quaisquer outros eventos que o aplicativo assinar.

    Campo para a URL do webhook do seu aplicativo GitHub

  13. Opcionalmente, no "Segredo do webhook", digite um token secreto opcional usado para proteger seus webhooks.

    Campo para adicionar um token secreto para seu webhook

    Observação: É altamente recomendável que você defina um token secreto. Para obter mais informações, consulte "Protegendo seus webhooks".

  14. Em "Permissões", escolha as permissões que o seu aplicativo irá solicitar. Para cada tipo de permissão, use o menu suspenso e clique em somente leitura, leitura & gravação ou Sem acesso.

    Várias permissões para o seu aplicativo GitHub

  15. Em "Assinar eventos", escolha se deseja assinar seu aplicativo para eventos de etiqueta, públicos, repositório or inspeção.

    Inscreva-se nas opções de eventos para seu aplicativo GitHub

  16. Para escolher o local onde o aplicativo pode ser instalado, selecione somente nesta conta ou qualquer conta. Para obter mais informações sobre as opções de instalação, consulte "Tornando um aplicativo GitHub público ou privado".

    Opções de instalação para o seu aplicativo GitHub

  17. Click Criar aplicativo GitHub.

    Botão para criar o seu aplicativo GitHub

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.