API e tokens
Como gerar e usar tokens de usuário, empresa, sistema e conexão para consumir consultas e armazenamentos.
Visão geral
A EasyAPI permite consumo externo de consultas e armazenamentos com tokens (API keys).
MCP (Model Context Protocol) não está implementado no Front/Api analisados — use tokens e links da plataforma.
Tipos de token
| Escopo | Onde gerar | Uso típico |
|---|---|---|
| Usuário | Usuários → Tokens / Gerar Token | Autenticar quem consome |
| Empresa | Empresas → Tokens | Escopo de empresa |
| Sistema | Sistemas → Tokens | Escopo de sistema |
| Conexão | Conexões → Tokens | Escopo de conexão |
Campos do token
| Campo | Descrição |
|---|---|
| Token | Valor da chave (somente leitura depois de gerado) |
| Data de criação | Auditoria |
| Data de expiração | Validade |
| Situação | Ativo ou bloqueado |
Como consumir uma consulta
- Cadastre a consulta com Token Usuário.
- Ligue Habilita Token Url e/ou Habilita Token Header.
- Abra Links e copie o link externo ou o cURL.
- Administrador pode ajustar Complementos Link.
O acesso externo combina o identificador da rotina com o token de usuário.
Como consumir um armazenamento
Armazenamentos também geram link externo com token (paginação típica no padrão da plataforma). Use o token de usuário correspondente e as permissões do perfil.
Segurança
- Defina expiração.
- Bloqueie chaves vazadas imediatamente.
- Não publique tokens em documentação, e-mail livre ou repositório.
- Prefira tokens de usuário nominais em vez de compartilhar uma chave única ampla.