Chaves de API
A página Chaves de API (datatorque.com.br/integrations/api-keys) permite criar credenciais para que sistemas externos (parceiros, ERPs, integrações) acesse dados da loja com segurança.
Acesso restrito a Admin da loja. Se a página não aparece no menu, solicite habilitação ao suporte.
Criando uma chave
Seção intitulada “Criando uma chave”Clique em Nova API key. O modal solicita:
Identificação da chave — use um nome que indique o sistema ou propósito (ex.: “Integração com parceiro X”, “Sincronização de leads”).
Permissões
Seção intitulada “Permissões”Selecione apenas o que a integração precisa:
| Permissão | O que permite |
|---|---|
| Leitura de negócios | Consultar negócios |
| Escrita de negócios | Criar e atualizar negócios |
| Leitura de contatos | Consultar contatos |
| Escrita de contatos | Criar, editar e desativar contatos |
| Leitura de relatórios | Consultar relatórios |
Expiração
Seção intitulada “Expiração”Escolha por quanto tempo a chave será válida:
| Opção | Validade |
|---|---|
| Nunca expira | Válida até ser revogada manualmente |
| 30 dias | Expira automaticamente após 30 dias |
| 90 dias | Expira automaticamente após 90 dias |
| 1 ano | Expira automaticamente após 1 ano |
| Personalizado | Escolha uma data e hora específicas |
Token gerado
Seção intitulada “Token gerado”Após criar a chave, o token completo é exibido uma única vez. Copie e armazene imediatamente em local seguro — não é possível recuperá-lo depois.
Envie o token ao responsável técnico da integração. Ele será usado para autenticar as requisições ao DataTorque.
Gerenciando chaves existentes
Seção intitulada “Gerenciando chaves existentes”A listagem exibe todas as chaves com:
- Nome e prefixo do token (parte visível para identificação)
- Status: Ativa, Revogada ou Expirada
- Permissões concedidas
- Data de criação e último uso
- Data de expiração (quando definida)
Auditoria
Seção intitulada “Auditoria”Clique em Auditoria em qualquer chave para ver o histórico de operações realizadas por ela (até 50 registros). Cada entrada mostra a ação, data/hora e origem.
Revogando uma chave
Seção intitulada “Revogando uma chave”Clique em Revogar na chave ativa. A confirmação avisa que a revogação é imediata e irreversível — qualquer sistema usando aquela chave perderá acesso na hora.