Como fazer login
Entenda o que é um token, como você o recebe ao fazer login, e como usa-lo para acessar a API da Contabeleza.
O que é um token?
Um token é como uma chave digital. Quando você faz login com seu e-mail e senha, a API verifica que você é quem diz ser e devolve uma chave. Essa chave é usada em todas as chamadas seguintes para provar que você tem permissao de acesso.
Pense no token como um cracha de identificacao: você o recebe na entrada e o apresenta em cada porta que precisa atravessar.
Como fazer login
Para receber um token, você precisa enviar seu e-mail e senha para a API. A resposta contem o token e uma lista de empresas (negocios) que você pode acessar.
Guarde o token com seguranca e escolha o ID do negocio que você quer usar. Cada chamada futura precisa de ambos: o token no cabecalho de autorizacao e o ID do negocio no cabecalho ilm-business.
Como usar o token
Em todas as chamadas depois do login, você envia o token no cabecalho Authorization, precedido pela palavra Bearer. Isso diz a API: "Aqui está minha chave, pode me deixar passar."
Se o token expirar ou for invalido, a API responde com um erro de não autorizado. Nesse caso, você precisa fazer login novamente ou usar o recurso de renovacao automatica (refresh token) se disponivel.
Outras formas de login
Além do e-mail e senha, a API também suporta:
- Telefone com codigo: você recebe um SMS e digita o codigo.
- Link magico: um link é enviado ao seu e-mail; clicar nele faz o login automatico.
- Chave de API: para integracoes automaticas entre sistemas, sem intervencao humana.
Entrar a partir do ilove.me
Quem usa o ilove.me PRO pode abrir a Contabeleza direto pelo menu da conta, em Acessar Contabeleza, sem fazer login de novo.
- No primeiro acesso, o ilove.me cria (ou vincula) a conta da pessoa na Contabeleza. Uma conta existente só é vinculada quando o telefone e o e-mail são os mesmos, e só quando o ilove.me já confirmou esses contatos.
- Gestores de salão (categoria gestor no ilove.me) só entram quando a empresa já é cliente da Contabeleza (mesmo CNPJ) e a pessoa faz parte dela. Caso contrário, o ilove.me mostra uma página com os serviços da Contabeleza e botões de WhatsApp para Quero saber mais e Já tenho contrato.
- Em cada acesso, o ilove.me pede à Contabeleza um link de entrada que vale por 30 segundos e só pode ser usado uma vez, e abre esse link numa nova aba.
- Para onde a pessoa vai: quem tem permissão de contabilidade (
management.accounting) numa empresa entra no painelmei.contabeleza.com.br; as demais pessoas vão parameipro.contabeleza.com.br.
A sessão aberta por esse link dura 1 hora.