Autenticação
A autenticação é feita através do fornecimento de dois tipos de tokens, sendo eles:
Account Token: token de sua conta, que serve para validar se a mesma existe do nosso lado. Esse token é enviado em todos os nossos webhooks e não tem qualquer permissão adicional.
User Token: token criado ao nível de usuário que será utilizado nas demais APIs públicas.
Nessa página:
Account Token
User Token
Account Token
Para obter seu Account Token, acesse a aba API na sua conta de cliente Guru.
Etapas:
1 - Acesso o admin da Guru com seu usuário e senha.
2 - No menu superior direito, clique em Minha Conta.
3 - Em API, copie e armazene o Token API.
User Token
Para obter seu User Token, acesse a aba API na sua conta de usuário. O User Token deve ser transmitido no header Authorization - Bearer {{user_token}}. Caso o token seja inválido ou não seja informado, o Digital Manager Guru retornará HTTP 401.
Adicionamos uma nova permissão Gerenciar Tokens de API, no nível de usuário, que permite que somente os administradores possam gerenciar tokens para qualquer usuário.
Atenção: os usuários não administradores precisarão ter essa permissão ligada para poder gerenciar seus tokens api.
Atenção! Seus Tokens carregam muitos privilégios, portanto se certifique de mantê-lo protegido. Não informe seu token em atendimentos e nem exponha no front-end da sua aplicação. Além disso, não é possível recuperá-lo em caso de perda, sendo necessário a geração de um novo.
Atenção ao tentar integrar a API:
Tenha responsabilidade ao partilhar sua chave api.
Fazer chamadas diretamente de um "frontend" é uma FALHA DE SEGURANÇA.
Se você está recebendo um erro de CORS, releia o item 2.
Etapas:
1 - Acesso o admin da Guru com seu usuário e senha.
2 - No menu superior direito, clique em Meu Perfil.
3 - No menu superior, clique em Tokens API.
4 - Em seguida, clique Adicionar.
5 - Informe o nome do Token API.
6 - Clique em Enviar.
7 - Em seguida, copie e armazene o Token API.
Atenção! Deve guardar o seu User Token em um lugar seguro, pois só poderá vê-lo uma única vez na Guru.