Esta funcionalidade está na fase Beta fechada, o que significa que somente clientes selecionados têm acesso a ela no momento. Caso tenha interesse em implementá-la futuramente, entre em contato com nosso Suporte.

Quanto mais antigo o token, maior o risco de exposição e de potenciais danos à operação. O procedimento de renovação do token garante a continuidade da segurança da sua loja e minimiza possíveis vulnerabilidades.

Renove o token de API com antecedência, ou seja, antes da duração expirar, para manter o acesso contínuo aos recursos e preservar a segurança.

Siga o passo a passo abaixo para renovar o token de uma chave de API:

1. Na barra superior do Admin VTEX, clique no avatar do seu perfil, marcado pela inicial do seu email, e depois em Configurações da conta > Chaves de API.

2. Certifique-se de que você está na aba Geradas.

3. Na linha de uma chave de API, clique no menu ⋮ e depois em Renovar token.

4. Clique em Copiar para copiar o token da API para a área de transferência. Esse segredo será exibido apenas uma vez. Salve-o em um local seguro.

5. Na seção Como excluir token antigo, marque uma das opções a seguir:

   • Depois: será necessário excluir manualmente o token antigo assim que o novo token estiver em uso nas integrações. Os dois tokens estarão válidos e funcionais até a exclusão do antigo. Na listagem da aba Geradas, na coluna Duração do token, vão aparecer os prazos de duração dos dois tokens, até o antigo ser excluído.

   • Agora: o token antigo será excluído do sistema ao finalizar o processo de renovação e apenas o novo token será válido.

   Caso a página seja fechada antes de selecionar uma forma de exclusão neste passo, a opção Depois será aplicada, ou seja, você precisará excluir o token antigo manualmente.

6. Clique em Finalizar.

Certifique-se de que o token antigo não está mais em uso por nenhuma integração antes de excluí-lo. Este procedimento não pode ser desfeito.

Siga as instruções abaixo para excluir manualmente um token antigo, após a renovação. Este procedimento é possível apenas quando a opção de excluir o token antigo Depois for selecionada ao renovar um token.

1. Na barra superior do Admin VTEX, clique no avatar do seu perfil, marcado pela inicial do seu email, e depois em Configurações da conta > Chaves de API.
2. Certifique-se de que você está na aba Geradas.
3. Na linha de uma chave de API, clique no menu ⋮ e depois em Excluir token antigo.
4. Para confirmar, clique em Excluir.

Este procedimento é possível apenas enquanto o token antigo não tiver sido excluído. Se o token antigo tiver sido excluído, será necessário renovar o token novamente ou excluir a chave de API.

Se você renovou o token por engano ou esqueceu de copiar o novo token gerado, siga os passos abaixo para desfazer a renovação.

1. Na barra superior do Admin VTEX, clique no avatar do seu perfil, marcado pela inicial do seu email, e depois em Configurações da conta > Chaves de API.
2. Certifique-se de que você está na aba Geradas.
3. Na linha de uma chave de API, clique no menu ⋮ e depois em Desfazer renovação.
4. Para confirmar, clique em Desfazer.

• Chaves de API (Beta)
• Configurar a duração de chaves de API (Beta)
• Chaves geradas (Beta)