# 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="/files/QmjTgjaY11PPgrCZWD6f" 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="/files/7nsLYZUawr6xkAvjbNs0" 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 %}


---

# Agent Instructions: Querying This Documentation

If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://docs.cange.me/api/autenticacao.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.