Como fazer login

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.

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.

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.

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.