Para que servem os tokens de acesso
Um token de acesso (também chamado chave API) permite que o seu próprio software, um programador ou uma ferramenta externa leia dados da sua loja através da API da Storeep. Cada token tem as suas próprias permissões, janela de dados e data de validade, para que possa dar a cada ferramenta exatamente o que precisa e retirá-lo a qualquer momento sem partilhar a sua palavra-passe.
Abra Configurações > Tokens de acesso. O botão Ver documentação abre a referência da API, com os endpoints, a forma de enviar o token e os limites de pedidos. Partilhe essa página com o seu programador.
Quer antes ligar um assistente de IA como o Claude ou o ChatGPT? Isso não usa tokens de acesso. Consulte Ligar um assistente de IA.
Criar um token
Clique em Criar novo token, preencha o formulário e clique em Criar.
- Nome do token: uma etiqueta para o reconhecer na sua lista, por exemplo "Sincronização da contabilidade". Só você a vê.
- Permissões: marque pelo menos uma:
- Ler produtos: listas de produtos, detalhes, variantes e inventário.
- Ler pedidos: histórico de pedidos, detalhes, estados e linhas de artigos.
- Ler webhooks: ver as configurações dos webhooks e os registos de entrega.
- Gerir webhooks: criar, atualizar e eliminar subscrições de webhooks através da API.
- Acesso a dados: até quando no passado o token pode ler.
- Últimas 24 horas: apenas os dados criados nas últimas 24 horas. A opção mais segura, boa para sincronizações em tempo real.
- Definir data de início: apenas os dados criados a partir de uma data que escolhe em Data de início do acesso a dados.
- Todo o período: todos os seus dados, sem limite de data.
- Validade: Nunca expira, ou Definir data de validade para escolher uma data até um ano à frente. Depois dessa data, o token deixa de funcionar sozinho.
Copie o seu token agora
Depois de clicar em Criar, a janela mostra O seu token de acesso com um botão de copiar. Este token só é mostrado uma vez. Copie-o e guarde-o num lugar seguro, como um gestor de palavras-passe. A Storeep não o pode mostrar de novo. Se o perder, elimine o token e crie um novo.
Trate-o como uma palavra-passe. Nunca o coloque no código de um site, em repositórios públicos, capturas de ecrã ou mensagens de chat.
A lista de tokens
- Nome, com a data em que foi criado.
- Permissões: por exemplo Leitura de produtos ou Leitura de pedidos.
- Acesso a dados: Últimas 24 horas, Todos os dados ou De uma data.
- Validade: uma data, ou Nunca.
- Última utilização: quando uma ferramenta usou o token pela última vez, ou Nunca.
Há um número máximo de tokens por loja. Quando o atinge, o botão Criar novo token desaparece até eliminar um.
Editar um token
Clique num token para mudar o nome, as permissões, o acesso a dados ou a validade. O valor do token continua o mesmo, por isso a ferramenta que o usa continua a funcionar com as novas regras.
Eliminar um token
Selecione um ou mais tokens e escolha Eliminar tokens, ou use o botão do caixote do lixo numa linha. O token deixa de funcionar imediatamente, e qualquer ferramenta que o use recebe um erro.
Dicas
- Dê a cada ferramenta o seu próprio token, para poder remover um sem estragar os outros.
- Escolha a janela de dados mais pequena que funcione.
- Defina uma data de validade para freelancers e trabalhos pontuais.
- Um token que mostra Nunca em Última utilização durante muito tempo provavelmente não é necessário. Elimine-o.
- Para que a Storeep envie os eventos dos pedidos para o seu servidor, em vez de o seu servidor os pedir, use webhooks.