# 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.

{% hint style="info" %}
**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.
{% endhint %}

## 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.

<figure><img src="https://3455492266-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FRwVy0iUEFA554Gv29SpL%2Fuploads%2FNLvzKkoI73r682kniUKK%2Fimage.png?alt=media&#x26;token=5df095b6-08ac-420e-bc3c-891a5d3b6269" alt=""><figcaption></figcaption></figure>

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.

<figure><img src="https://3455492266-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FRwVy0iUEFA554Gv29SpL%2Fuploads%2FeNsL5SVoenZZfkRmEcbF%2Fimage.png?alt=media&#x26;token=d2c09251-4040-4082-9211-91b65dfa9c23" alt=""><figcaption></figcaption></figure>

4. **Criar Novo Token Pessoal:**&#x20;
   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.

{% hint style="info" %}
**TIP**

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

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 autenticaçã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.

```http
https://api.cange.me/session
```

<mark style="color:green;">`POST`</mark> `/session`

Endpoint com o objetivo de retornar o token de acesso.

**Headers**

| Name         | Value                  |
| ------------ | ---------------------- |
| Content-Type | `application/json`     |
| Origin       | `https://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**

{% tabs %}
{% tab title="200" %}

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

{% endtab %}
{% endtabs %}