> ## Documentation Index
> Fetch the complete documentation index at: https://docs.toolzz.dev/llms.txt
> Use this file to discover all available pages before exploring further.

# Token do Administrador

> Gere o token de autorização que será usado nas suas requisições.

## Parâmetros

<ParamField body="email" type="string" required>
  E-mail do administrador da instituição.
</ParamField>

<ParamField body="institution_code" type="string" required>
  Subdomínio da sua instituição (nome na url).
</ParamField>

<ParamField body="password" type="string" required>
  Senha de login do administrador da instituição.
</ParamField>

<Note>Antes de começar, é necessário ter uma conta de administrador na plataforma Toolzz.
Caso você ainda não possua uma, acesse o site da plataforma e siga as instruções para criar uma conta. Isso lhe dará as credenciais de login necessárias para se autenticar nas APIs</Note>

### Acessar o Endpoint de Login:

1. Para obter um token de acesso, você precisa enviar uma solicitação POST para o endpoint de login da API. O endpoint padrão para login é `/api/auth/login`
2. Após enviar a solicitação de login, você receberá uma resposta do servidor. O token de acesso estará incluído na resposta como `access_token`. Esse token será usado para autenticar-se em outras solicitações às APIs da Plataforma Toolzz.
3. Para acessar os endpoints protegidos nas APIs, você deve incluir o token de acesso no cabeçalho de autorização de suas solicitações. O cabeçalho deve ser configurado da seguinte forma: `Authorization: Bearer SEU_TOKEN_AQUI`
4. Agora que você possui um token de acesso válido, pode usá-lo para realizar solicitações aos endpoints das APIs que fornecem acesso aos dados e funcionalidades da instituição à qual você está vinculado.

<Warning>Lembre-se de manter sempre suas credenciais e tokens de acesso seguros. Evite compartilhá-los e armazene-os de forma segura.</Warning>

1. **Obtenção do Token:**\
   Para obter um token de acesso, envie uma requisição POST para o endpoint `/api/auth/login` com os seguintes dados:

```javascript Code Block Example theme={null}
{
  "email": "admin@instituicao.com",
  "institution_code": "nome-subdominio",
  "password": "sua_senha"
}
```

2. **Resposta da API:**
   Após a requisição bem-sucedida, você receberá um token de acesso no campo access\_token da resposta. Exemplo:

```javascript Code Block Example theme={null}
{
  "access_token": "eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9..."
}
```

3. **Autenticação em Endpoints Protegidos:**
   Para acessar os endpoints protegidos nas APIs, você deve incluir o token de acesso no cabeçalho de autorização de suas solicitações. O cabeçalho deve ser configurado da seguinte forma: `Authorization: Bearer SEU_TOKEN_AQUI`

4. **Acesso às Funcionalidades:**
   Agora que você possui um token de acesso válido, pode usá-lo para realizar solicitações aos endpoints das APIs que fornecem acesso aos dados e funcionalidades da instituição à qual você está vinculado.