Chaves de API
Uma chave de API é uma credencial que permite que outro sistema (um parceiro, um ERP, uma automação) acesse os dados da sua loja com segurança. Para abrir, vá em Empresa → Chaves de API.
Apenas o Admin da loja acessa esta página. Se ela não aparece no menu, fale com o suporte.
Criar uma chave
Seção intitulada “Criar uma chave”- Clique em Nova chave.
- Dê um nome que indique o sistema ou o propósito (ex.: “Integração com parceiro X”).
- Marque apenas as permissões que a integração precisa (ver abaixo).
- Escolha a expiração (recomendado definir um prazo).
- Confirme.
Gerenciar as chaves existentes
Seção intitulada “Gerenciar as chaves existentes”A lista mostra cada chave com nome, prefixo do token, status (Ativa, Revogada ou Expirada), permissões, datas e último uso. Clique em uma chave para abrir o painel com detalhes e auditoria.
- Auditoria: veja o histórico de operações daquela chave.
- Excluir chave: corta o acesso na hora (pede uma confirmação). A ação é imediata e irreversível: qualquer sistema usando a chave perde o acesso.
Referência: permissões
Seção intitulada “Referência: permissões”| Permissão | O que libera |
|---|---|
| Ler negócios | Consultar negócios |
| Gerenciar negócios | Criar e atualizar negócios |
| Ler contatos | Consultar contatos |
| Gerenciar contatos | Criar, editar e desativar contatos |
| Ler relatórios | Consultar relatórios |
| Ler análise veicular | Consultar análises veiculares |
| Solicitar análise veicular | Pedir novas análises (consome créditos) |
| Vender análise avulsa | Vender uma análise avulsa |
| Ler carteira | Consultar o saldo de créditos |
Referência: opções de expiração
Seção intitulada “Referência: opções de expiração”| Opção | Validade |
|---|---|
| Nunca expira | Até ser revogada manualmente |
| 30 / 90 dias / 1 ano | Expira automaticamente nesse prazo |
| Personalizado | Uma data e hora específicas |