Ao tentar acessar algum endpoint da API de Integração, pode acontecer de ser apresentado o retorno com o Status HTTP 403 - Forbidden / Permissão Negada.

Exemplo prático

Por que esse erro é retornado?

Normalmente esse erro é apresentado quando o Token da API de Integração, não possui permissão para acessar o endpoint / url desejada.

Um Token da API de Integração é sempre vinculado a um Usuário / Cliente do Painel Administrativo, então esse Usuário / Cliente precisa ter permissão para acessar os módulos / endpoints desejados.

Se o usuário não possuir permissão para acessar as Tags, então realmente será apresentada a mensagem de permissão negada.

Como liberar as permissões de acesso necessárias?

1- Acesse o Painel Administrativo da sua loja virtual
2- Vá no menu "API de Integração"

Importante: É necessário que o usuário logado no Painel Administrativo tenha permissões para acessar esse menu, do contrário, ele não será exibido.

3- Agora você irá conseguir visualizar todos os tokens de integração cadastrados e seus respectivos usuários vinculados:

Permitindo assim verificar qual usuário / cliente está vinculado ao token que está sendo utilizado na requisição:

Em nosso exemplo o Usuário "Mauro Ribeiro" está sendo utilizado para o token "8989898bn0md32n5wokoog8wswk4g4gcocwo00wsss0okgsggsgwg08"

4- Clique no usuário "Mauro Ribeiro" para visualizar o Detalhes desse Usuário / Cliente:

5- Agora clique no botão de "Editar"

6- Na tela de edição do cliente, role a página até encontrar as "Permissões de Acesso", veja que o usuário não possui permissão para a gestão de produtos:

7- Habilite as permissões necessárias (em nosso caso, precisamos habilitar a permissão "Gerente de Produto" para ter acesso as Tags).

Dica: É possível clicar em "Gerenciar Perfis de Acesso" para conceder permissões detalhadas para o usuário (é possível liberar permissões apenas para listar, editar, cadastrar ou deletar determinados registros).

8- Pronto! Agora ao tentar fazer novamente a requisição, iremos verificar que ela irá funcionar e não mais retornará a permissão 403.

Boas Práticas de Segurança

- Recomendar criar usuários específicos para serem utilizados pela API de Integração, assim é possível controlar as ações que são realizadas pela API.

- Recomendamos liberar somente as permissões de acesso desejadas para cada Usuário, assim evita-se que um usuário tenha permissões demais a módulos que não são necessários.