KCS - Erro de Acesso Negado (40301) na API

❌ Erro de Acesso Negado (40301) na API

🕒 Tempo aproximado para leitura: 00:01:00 min

---

❓ Dúvida:

Ao tentar consumir uma rota específica da API do Tiflux, o cliente recebe o erro {"error_code": 40301, "message": "Access Denied - You cannot access this route", ...}. O cliente precisa entender o motivo desse erro.

{
  "error_code": 40301,
  "message": "Access Denied - You cannot access this route",
  "detail": {
    "error": [
      "You are not authorized to access this page."
    ]
  }
}

---

🔎 Causa:

O código de erro 40301 e a mensagem "Access Denied" indicam uma falha de autorização ou permissão.

O usuário ou a chave de API utilizada para fazer a chamada não possui as permissões necessárias para acessar aquela rota ou os dados específicos solicitados. A causa mais provável é que um dos parâmetros inseridos na chamada da API (como um ID de cliente, de ticket ou de usuário) não está acessível ao perfil de permissão do usuário da API.

---

✅ Solução:

O cliente deve verificar as seguintes possibilidades para solucionar o erro:

1. Verificar Permissões do Usuário: Certifique-se de que o usuário ou token de API possui todas as permissões de leitura/escrita necessárias no Tiflux para a rota que está sendo consumida.

2. Revisar os Parâmetros: Verifique se algum parâmetro na chamada da API (por exemplo, client_id, user_id, ou ticket_id) está fazendo referência a um recurso que está fora do escopo de acesso do usuário logado na API.

3. Consultar a Documentação da API: Verifique a documentação oficial da API para confirmar os requisitos de permissão para a rota específica em uso.

   1. https://api.tiflux.com/api/v2/

Se as permissões parecerem corretas, mas o erro persistir, o cliente deve entrar em contato com o suporte técnico, fornecendo o endpoint e a chave utilizada (se for o caso) para análise.

---