Gerenciar Developer Tokens
Developer Tokens são credenciais de autenticação no formato JWT que permitem a aplicações externas acessar a API do DATAHILL. Cada token é específico para um usuário e uma empresa no DATAHILL, e cada usuário pode ter diversos tokens por empresa. Os tokens devem ser mantidos em segurança e não devem ser compartilhados publicamente.
Antes de começar
Todos os níveis de acesso podem criar e gerenciar Developer Tokens. O nível de permissão do token criado não pode ser superior ao seu próprio nível de acesso.
| Seu nível | Níveis de token permitidos |
|---|---|
| Administrador | Administrador, Gerente, Visitante |
| Gerente | Gerente, Visitante |
| Visitante | Visitante |
Níveis de acesso
| Nível | Descrição |
|---|---|
| Administrador | Pode gerenciar configurações, proprietários, gerentes e visitantes. |
| Gerente | Pessoas na sua empresa que podem gerenciar indicadores e painéis, mas não podem alterar configurações. |
| Visitante | Pessoas externas à empresa que podem apenas visualizar indicadores e painéis. |
Criar um Developer Token
- Acesse Configurações > Developer token no portal.
- Clique em Adicionar.
- Preencha os campos:
- Nome para identificação — nome descritivo para identificar o token (ex.: "Integração ERP").
- Expirar após — data de validade do token. O padrão é um mês a partir de hoje.
- Nível de acesso — permissão que o token terá sobre os dados.
- Clique em Gerar token.
O token é exibido uma única vez na tela de confirmação. Copie e armazene em um local seguro imediatamente. Não será possível visualizá-lo novamente.
Após a geração, todos os administradores da empresa recebem uma notificação por email informando que um novo token foi criado.
Consultar seus tokens
Acesse Configurações > Developer token para ver a lista de tokens ativos. Para cada token, são exibidos:
- Nome
- Nível de acesso
- Data de expiração
- Último acesso
Tokens expirados são identificados com a etiqueta Expirou em DD/MM/YYYY. Tokens que nunca foram utilizados são identificados com a etiqueta Não utilizado.
Excluir um Developer Token
- Na lista de tokens, selecione o token desejado.
- Clique no menu Mais opções.
- Selecione Excluir.
Após a exclusão, o token é invalidado imediatamente e não pode mais ser utilizado para autenticação.
Uso na API
Para usar um Developer Token em requisições à API, inclua o cabeçalho Authorization:
Authorization: Bearer {seu_token}
Veja exemplos práticos de uso na página Primeiros passos com a API.
Veja também
- Primeiros passos com a API — fluxo básico de integração com a API.
- Documentação da API — referência completa de endpoints e parâmetros.