Ao criar seu aplicativo diretamente na plataforma Developers Hub, você simplifica ainda mais o acesso para os seus usuários, além de permitir que você crie integrações para acessar dados externamente via a API pública.
Para acessar a API pública, é necessário criar um aplicativo que atuará como cliente em nome do usuário. Gere a sua credencial para o seu aplicativo clicando aqui.
Para cadastrar, é bem simples: basta seguir os passos a seguir:
Como cadastrar
Na aba "Meus aplicativos", clique no botão "+ Novo Aplicativo":
Preencha todos os campos obrigatórios e selecione os escopos que seu aplicativo irá utilizar. Após, clique em "Criar Aplicativo":
Obs: Se necessário, consulte a documentação de cada endpoint que seu aplicativo acessa para determinar os escopos necessários na hora de preencher.
- Nome do seu aplicativo: Nome escolhido para melhor identificação;
- Website: Site de divulgação do seu aplicativo;
- Descrição: Descrição breve sobre o que o aplicativo faz;
- Quais escopos você gostaria de ter acesso: Listagem com todos os escopos de APIs disponíveis para integração.
Leia com atenção os Termos de Serviço, aceite, caso esteja de acordo, e então clique em "Criar aplicativo":
Ao receber a confirmação de que seu aplicativo foi criado, clique em "Copiar e Fechar" para copiar suas credenciais:
Obs: Em virtude da LGPD, a Eduzz não pode salvar credenciais dos usuários, por isso, é importante que você copie e salve as credenciais, pois, caso perca a secret, será necessário gerar uma nova.
Detalhes do Aplicativo
Com seu aplicativo criado, você pode configurar e customiza-lo da forma que preferir, além de ter acesso a informações do seu aplicativo, de seus desenvolvedores e URLs de retornos.
Na primeira tela, você pode "Gerar URL de Login" ou "Editar" as informações do seu aplicativo:
- Gerar URL de Login: Ao cadastrar uma URL de retorno, será gerado uma tela de login para seus usuários se autenticarem;
- Nome do aplicativo: É exibido o nome do aplicativo configurado no passo anterior;
- Status: Mostra os status do seu aplicativo;
- Status de Moderação: Indica o status de moderação do aplicativo. Se escopos restritos estiverem selecionados, os aplicativos precisam passar por um processo de moderação antes de se tornarem ativos ou de terem acesso a certas funcionalidades;
- Descrição: Descrição configurada no cadastro do aplicativo;
- Website: Site configurado no cadastro do aplicativo;
- Escopos: Escopos selecionados e liberados para utilização;
- Escopos pendentes: Escopos restritos que não foram liberados para utilização.
Na sessão "Desenvolvedores", você pode adicionar até 5 desenvolvedores para terem acesso e se autenticarem no aplicativo enquanto ele estiver com status "Em desenvolvimento". Para cadastrar, basta clicar em "Adicionar" e preencher com o e-mail do desenvolvedor. Um convite será enviado ao mesmo.
Já na tela "URLs de Retorno" é possível cadastrar URLs onde nós iremos enviar o código de autenticação Oauth apenas para URLs cadastradas.
Obs: Para o aplicativo ir para produção é necessário que ele tenha no mínimo 1 URL de retorno para elevar a segurança dos aplicativos.
Como Enviar para Desenvolvimento
Esse passo deve ser feito após a conclusão do cadastro do seu aplicativo
Na tela Meus aplicativos, clique no botão de ação (três pontos) do aplicativo que deseja e então em "Enviar para Produção":
Assim que enviado, o status do seu aplicativo dai alterar para "Produção":
Ficamos muito felizes em te ajudar!😃
Ainda precisa de ajuda? Estamos prontos para te atender! 🙂
Caso ainda haja dúvidas, envie uma solicitação para nossa equipe de suporte pelo link do Formulário.
Neste link será pedido algumas informações para que sua identidade seja validada e será onde você poderá relatar o seu problema, para que assim sua dúvida seja encaminhada para a equipe de atendimento, garantindo que sua solicitação seja atendida. 😉