Como gerar e proteger sua chave (Token) de API
O token de API é uma chave de acesso que permite consultar informações e desenvolver integrações com sua loja. Pense nele como a senha e o token de acesso à conta bancária do seu negócio. O tratamento inadequado pode expor sua operação a riscos.
SUAS CHAVES DE API SÃO AS CHAVES DO SEU NEGÓCIO
Sua loja virtual é a fonte de renda da sua empresa. Assim como você protege suas informações bancárias, suas chaves de API devem ser tratadas com o máximo rigor. Uma chave exposta pode permitir que um invasor visualize, altere ou até apague dados vitais como produtos, clientes e pedidos, comprometendo diretamente seu faturamento. A regra de ouro é: conceda apenas as permissões (escopos) estritamente necessárias.
Importante: lembre de revisar frequentemente os Tokens criados na sua conta. Desse modo, você garante uma melhor gestão para o seu negócio.
Para trabalhar com a API, é importante entender como ela funciona. Neste artigo, você acessa as documentações da nossa API e tudo que pode ser feito a partir dela.
Como gerar um token de API
- Vá em Admin > Configurações > Integrações > API;
- Clique no ícone de + para gerar um novo token:
- Preencha com o nome da integração ou com alguma informação que seja fácil de identificar a origem futuramente (ex: "Integração ERP XPTO") e o e-mail de quem deve receber o token:
- Defina cuidadosamente os escopos aos quais essa chave terá acesso.
Atenção ao definir escopos! Os escopos são as permissões que a chave terá. Cada escopo liberado é como autorizar uma nova operação na sua conta. Nunca selecione todos os escopos por conveniência.
Conceda apenas as permissões estritamente necessárias para a integração funcionar. Por exemplo, se uma ferramenta precisa apenas ler pedidos, conceda somente o escopo order-read. Conceder permissão para escrever (write) ou apagar dados sem necessidade cria uma grave falha de segurança.
- Feito isso, clique em SALVAR. O token será gerado e enviado ao e-mail selecionado. O assunto do e-mail sempre será Token de acesso para API da Olist.
Dica: recomendamos que os tokens criados sejam revisados periodicamente, a fim de identificar e remover aqueles que não estão mais em uso. Essa prática contribui para uma gestão mais organizada e eficiente.
