Autenticação

Para utilizar a API do Cange, é essencial autenticar cada solicitação. Utilizamos um sistema baseado em tokens JWT, que proporciona segurança e confiabilidade nas transações. A autenticação via a API do Cange requer o uso de um e-mail associado à conta e um token pessoal. Abaixo, você encontrará um guia passo a passo sobre como obter o seu token de autenticação.

TIP

Verifique se o seu plano inclui suporte ao uso de API no Cange. Além disso, é necessário ter um perfil de administrador no ambiente para que seja possível gerar tokens pessoais.

Gerando o token pessoal

1. Entrar na Plataforma: Acesse a plataforma Cange e faça login utilizando suas credenciais.

2. Acessar a Página de Perfil do Usuário: Navegue até a página de perfil do seu usuário. Essa opção está disponível ao clicar no ícone de avatar localizado no canto inferior esquerdo do menu de navegação.

3. Ir para a Aba de Aplicativos: Dentro da página de perfil, vá até a aba "Aplicativos". Nesta seção, você encontrará a opção de criar um novo token pessoal.

4. Criar Novo Token Pessoal:

   1. Clique no botão "Criar novo token". Dê um nome descritivo ao token, que facilite a identificação do seu propósito. Em seguida, clique em "Salvar".

   2. Após salvar, seu token pessoal será gerado. Copie-o e guarde-o em um local seguro, pois ele não será exibido novamente.

TIP

É fundamental armazenar o token em um local seguro após copiá-lo, uma vez que ele não poderá ser exibido novamente.

Com o token pessoal em mãos, você está pronto para iniciar a configuração da chamada de autenticação utilizando o endpoint adequado.

Realizando a chamada de atutenticação

Após ter em mãos o seu token pessoal, você pode iniciar a configuração da chamada de autenticação, o endpoint utilizado será o endpoint abaixo.

https://api.cange.me/

POST /session

Endpoint com o objetivo de retornar o token de acesso.

Headers

Name	Value
Content-Type	application/json
Origin	http://app.cange.me

Body

Name	Type	Description
email	string	E-mail do usuário que gerou o token de acesso pessoal
apikey	string	Token de acesso pessoal gerado

Response

200

{
"token": "tokenDeAutenticação..."
}