Token de acesso

Para acessar as APIs de Vnda você precisa de uma chave de acesso (token) de autenticação. O token delimita as permissões de acesso do usuário, para que você possa controlar os dados e ações da sua loja conforme deseja. O token é gerado acessando o Admin, onde você também pode alterar as permissões ou excluir definitivamente um token.

📘

Tokens gerados e utilizados no ambiente de produção são diferentes dos gerados no ambiente de testes.

Nesse artigo você confere:

• Como gerar um token;
• Editar as permissões ou excluir um token.

Gerar token

Para criar um token de acesso para um usuário:

1. Acesse o Admin;
2. Clique no ícone ⚙ de Configurações no canto inferior esquerdo;
3. Clique em API na seção Integrações;
4. Clique em +;
5. Preencha o Nome e E-mail do responsável pelo uso do token;
6. Clique em Continuar;
7. Selecione a caixa de seleção ☑ para as opções de permissão do token, pois cada opção permite o acesso a uma API específica;
8. Clique em Salvar.

🚧

O token é enviado pelo e-mail cadastrado no passo 5. Veja sua caixa de entrada e spam, mas caso você não tenha recebido o e-mail entre em contato pelo e-mail [email protected]. Tokens e URLs gerados e utilizados no ambiente de produção são diferentes dos gerados no ambiente de teste.

Excluir ou editar um token

O token não tem prazo de expiração, no entanto você pode excluir ou editar um token. Para editar ou excluir as permissões de um token:

1. Acesse Configurações > Integrações > API;
2. Selecione na lista o usuário de token qual deseja alterar;
3. Para editar:
   1. Clique no ícone de edição.
   2. Marque ou desmarque as caixas de seleção ☑ que deseja adicionar ou excluir respectivamente.
   3. Clique em Salvar.
4. Para inativar (excluir) as permissões de um token:
   4. Clique no ícone de lixeira.
   5. Clique em Sim.

❗️

• Tokens inativados não podem ser reativados novamente.
• As permissões dos tokens dependem do ambiente de uso: tokens criados no ambiente de produção permitem requisições no ambiente de produção, tokens criados no ambiente de teste permitem requisições no ambiente de teste.