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

# Configuração de Tokens de API

Este guia explica como configurar e gerenciar tokens de API através da interface do Synkrony.

## Acessando o Gerenciamento de API

1. **Faça login** na sua conta do Synkrony
2. **Navegue para Configurações** clicando no menu lateral
3. **Selecione a seção "API"** nas configurações

> Somente o administrador da empresa pode gerenciar tokens de API

## Criando um Novo Token de API

### Passo a Passo

1. **Na página de API**, clique no botão **"Adicionar Chave"**
2. **Digite um nome** descritivo para o seu token (ex: "Integração CRM", "Automação Deploy")
3. **Clique em "Criar"** para gerar o token

### ⚠️ Importante - Copie o Token Imediatamente

* Após a criação, o token completo será exibido **apenas uma vez**
* **Copie e salve o token** em um local seguro
* O sistema mostrará apenas os últimos 4 caracteres do token após essa tela

## Gerenciando Tokens Existentes

### Visualizando Tokens

Na página de API, você verá uma lista com todos os seus tokens contendo:

* **Nome do Token**: Nome descritivo que você definiu
* **Token**: Últimos 4 caracteres (ex: `•••••••••••abcd`)
* **Criado em**: Data de criação do token
* **Último uso**: Data da última utilização (se aplicável)

## Utilizando o Token de API

### Formato de Autenticação

Para usar o token em suas requisições à API, inclua o cabeçalho de autorização:

```
Authorization: Bearer SEU_TOKEN_AQUI
```

### Exemplo de Requisição

```bash theme={null}
curl -H "Authorization: Bearer seu_token_completo_aqui" \
     -H "Content-Type: application/json" \
     https://synkrony.ai/api/v1/projects
```

### Endpoints Disponíveis

A API do Synkrony oferece os seguintes endpoints:

* `/api/v1/projects` - Gerenciamento de projetos
* `/api/v1/tasks` - Gerenciamento de tarefas
* `/api/v1/project_modules` - Gerenciamento de módulos de projeto

## Segurança e Boas Práticas

### Segurança do Token

* **Mantenha seus tokens seguros**: Nunca compartilhe ou exponha tokens em código público
* **Use nomes descritivos**: Facilita a identificação e gerenciamento
* **Revogue tokens não utilizados**: Remove tokens antigos ou desnecessários
* **Monitore o uso**: Verifique regularmente a data de "último uso"

### Isolamento por Empresa

* Cada token é **restrito à sua empresa**
* Você só pode acessar dados da sua organização
* Tokens não podem ser compartilhados entre empresas diferentes

### Permissões

* Para gerenciar tokens de API, você precisa ter **permissões de administração** na empresa
* Apenas usuários com papel de `owner` ou `super_admin` podem criar, editar ou excluir tokens

## Contato

Para suporte adicional ou documentação avançada da API, entre em contato com nossa equipe de desenvolvimento.