Os tokens de API permitem-te aceder à WEMASY de forma programática. É uma funcionalidade avançada para programadores que querem integrar a WEMASY com outras ferramentas ou automatizar tarefas.
O que é um token de API?
Um token de API é uma sequência única de caracteres que funciona como credencial de autenticação. Em vez de usarem o teu email e a tua palavra-passe, as aplicações externas usam este token para comunicarem com a WEMASY em teu nome, de forma segura.
Os tokens de API são usados sobretudo para:
- Integrar a WEMASY com ferramentas e serviços de terceiros.
- Automatizar tarefas repetitivas com scripts.
- Criar fluxos de trabalho personalizados que usam os dados do teu projeto WEMASY.
Como criar um token de API
Os tokens de API gerem-se nas definições do projeto.
- Abre o teu projeto na WEMASY.
- Vai a Definições do projeto.
- Vai à secção Acesso à API.
- Clica no botão para criar um novo token de API.
- Dá ao token um nome claro para mais tarde saberes para que serve.
- Clica em Criar para gerar o token.
Nota: O teu token de API só aparece uma vez, no momento em que é criado. Copia-o logo e guarda-o num sítio seguro. Não vais conseguir voltar a ver o token completo.
Gerir os teus tokens de API
Podes ver a lista dos teus tokens de API na secção Acesso à API. A partir daqui podes:
- Ver o nome e a data de criação de cada token.
- Revogar os tokens de que já não precisas.
Revogar um token desativa-o de imediato. As aplicações ou scripts que usam esse token deixam de conseguir aceder à WEMASY.
Boas práticas de segurança
- Nunca partilhes os teus tokens de API em público nem os incluas em repositórios de código.
- Usa um token diferente para cada integração, para poderes revogar o acesso de cada uma em separado.
- Revoga os tokens que já não usas.
- Trata os tokens de API como palavras-passe. Quem tiver o teu token pode aceder aos dados do teu projeto.
Dica: Se suspeitares que um token foi comprometido, revoga-o de imediato e cria um novo.