Como cadastrar os aplicativos e gerar App Token e Access Token para Integração com a API da Superlógica
Visão geral
Este conteúdo detalha o procedimento para cadastrar aplicativos e gerar as chaves de autenticação (App Token e Access Token) no sistema Superlógica Imobiliárias. As chaves são necessárias para integrar ferramentas externas (como CRMs, sites, plataformas de vistoria ou sistemas de BI) à API do ERP.
Quando usar este artigo
Utilize este guia sempre que houver necessidade de conectar um sistema terceiro ou desenvolvimento próprio à API da Superlógica, gerando novas credenciais de acesso ou consultando tokens de aplicativos já cadastrados.
Sintoma ou cenário
A imobiliária contratou ou desenvolveu uma solução externa e precisa das credenciais de autenticação (App Token e Access Token) para configurar a comunicação com a API do ERP Superlógica Imobiliárias.
Benefício para o usuário ou operação
Autonomia no gerenciamento de integrações com a API.
Segurança no controle do acesso de sistemas terceiros aos dados do ERP.
Maior agilidade e automação na gestão e integração de sistemas da imobiliária.
Onde acessar / contexto de uso
Acesse o gerenciamento de tokens no menu do usuário (canto superior direito da tela) navegando até Menu do usuário > Todos os usuários.
Pré-requisitos (Antes de começar)
Perfil Exato: Permissão de administrador ou de escrita/gestão no módulo de Gestão de Usuários e Licenças.
Recursos Sistêmicos: Acesso à API liberado na licença do ERP Superlógica Imobiliárias.
Insumos e Dados Técnico: Nome e descrição da aplicação/sistema parceiro que será integrado.
Causas prováveis
Demanda operacional para integração de softwares externos (CRMs de vendas/locação, portais imobiliários, ferramentas de assinatura digital ou esteiras de locação) via webservice da Superlógica.
Como fazer ou corrigir
1. Cadastrando um Novo Aplicativo e Gerando os Tokens
No canto superior direito do ERP, clique no seu ícone de perfil e acesse Menu do usuário > Todos os usuários;
Role a tela até o final da página para visualizar as abas de aplicativos;
Selecione a aba Aplicativos (e-mail do usuário conectado);
Clique no botão Novo app token;
Insira o Nome do aplicativo e uma Descrição que facilite a identificação da ferramenta;
Clique em Salvar;
Ao finalizar o cadastro, os tokens de integração (App Token e Access Token) serão exibidos na tela. Copie e guarde essas informações em um local seguro, pois algumas chaves não são exibidas novamente na íntegra.
2. Consultando Tokens de Aplicativos Já Cadastrados
Para consultar o Access Token:
Acesse Menu do usuário > Todos os usuários e vá até o final da página;
Acesse a aba Aplicativos liberados;
Localize o aplicativo desejado e passe o ponteiro do mouse sobre ele;
Clique em Ver access token para visualizar o código.
Para consultar o App Token:
Acesse a aba Aplicativos (e-mail do usuário conectado);
Na coluna Token, clique em Ver Token na linha correspondente ao aplicativo.
Atenção: Apenas o usuário que realizou o cadastro inicial do aplicativo possui permissão para visualizar o App Token.
Resultado esperado
Escalone para o suporte técnico do Superlógica Imobiliárias caso o sistema apresente mensagens de erro ao salvar o aplicativo, se os tokens gerados retornem erro de autenticação (HTTP 401 Unauthorized ou 403 Forbidden) na API mesmo com a estrutura do header correta, ou se o botão de geração de token estiver indisponível.
Quando escalar
Caso o sistema apresente mensagens de erro impeditivas ou se o comportamento divergir do esperado após a execução dos passos.
Informações para escalonamento
Ao abrir chamado no suporte técnico, forneça:
Nome e ID da licença da imobiliária.
E-mail do usuário no qual o token foi gerado.
Nome e descrição do aplicativo cadastrado.
Print da tela de erro ou do retorno (Response Body/Code) da requisição da API.
Regras importantes / Observações
Sigilo das Credenciais: O App Token e o Access Token funcionam como senhas de acesso direto aos dados da imobiliária via API. Nunca compartilhe essas chaves publicamente.
Restrição do Criador: O App Token só pode ser consultado pelo usuário que efetuou o seu cadastro. Outros usuários administradores conseguem visualizar apenas o Access Token na aba Aplicativos liberados.
Escopo de Permissão: As ações executadas pela API utilizando os tokens herdam o nível de permissão cadastrado para o usuário proprietário do token no ERP.
Problemas comuns e como resolver
Problema: O usuário não encontra a opção "Ver Token" para o App Token de um aplicativo já existente.
Causa provável: O aplicativo foi cadastrado por outro usuário da licença.
Ação recomendada: Peça para o usuário que cadastrou o aplicativo acessar o sistema e consultar o App Token na aba Aplicativos (e-mail do usuário conectado), ou cadastre um novo App Token com o usuário atual.
Problema: Falta de autorização ao tentar consumir os endpoints da API Superlógica.
Causa provável: Formatação incorreta nos headers HTTP da requisição (
app_tokenouaccess_tokenausentes ou trocados).Ação recomendada: Verifique na documentação técnica da API se os parâmetros
app_tokeneaccess_tokenestão sendo enviados corretamente no cabeçalho (header) das requisições.
Dúvidas relacionadas (FAQ)
P: Como conferir se a ação em ‘Como cadastrar os aplicativos e gerar App Token e Access Token para Integração com a API da Superlógica’ foi validada em sistema? R: Consulte os logs de auditoria de usuário ou extraia um relatório rápido do respectivo módulo.
P: Restrições de acesso implicam no salvamento dessa rotina? R: Apenas perfis com atributo de ‘Escrita’ conseguem consolidar alterações; caso contrário, o botão de salvamento aparecerá bloqueado.
Palavras-chave de busca
como cadastrar os aplicativos e gerar app token e access token para integração com a api da superlógica, suporte superlógica imobiliárias, ajuda, manual, base de conhecimento, api superlógica imobi, geracao token integracao, app token access token.