Erros e problemas comuns
Hora de início é posterior à hora de término #
Este erro ocorre quando a hora de início na sua solicitação de API é posterior à hora de término, geralmente devido a uma incompatibilidade entre os fusos horários locais e o UTC, que é o esperado pela API do Clockify.
Por que isso acontece:
- A API do Clockify usa o horário UTC para todos os valores baseados em tempo
- Enviar uma hora de início no horário local (por exemplo, Bruxelas +1) sem convertê-la para UTC pode resultar em uma hora de início posterior à hora de término
Como corrigir:
- Certifique-se de que as horas de início e término na sua solicitação sejam convertidas para UTC.
- Verifique novamente a solicitação de API completa:
- Endpoint utilizado
- Corpo da requisição e campos de hora
- Cabeçalhos (especialmente Content-Type e autenticação)
- Configurações de fuso horário no servidor ou script que gera a requisição
Mesmo que uma hora de início diferente de UTC seja aceita, o cronômetro pode começar com uma duração negativa, o que pode afetar os cálculos e os relatórios. A conversão para UTC resolve esse problema completamente.
403 – Proibido #
Este erro significa que sua solicitação foi entendida pelo servidor, mas você não está autorizado a executar a ação devido à ausência de permissões ou restrições de recursos.
Por que isso acontece:
- A chave de API em uso não tem permissão para a operação solicitada
- A função do usuário (por exemplo, Gerente de Projeto ou Gerente de Equipe) tem acesso limitado
- O plano de assinatura não inclui o recurso solicitado
- Você está solicitando um relatório com valores, mas não tem permissão para visualizá-los
Como corrigir:
- Verifique a função e as permissões do usuário:
Certifique-se de que a chave de API pertença a um usuário com a função e o acesso corretos ao recurso.
- Verifique a assinatura:
Alguns endpoints e recursos exigem um plano pago, como "Adicionar tempo para outros", por exemplo.
- Regenere sua chave de API:
- Clique na sua foto de perfil e selecione Preferências
- Abra a aba Avançado
- Clique em Gerenciar chaves API ao lado do campo API
- Se estiver gerando um relatório como Gerente de Projeto ou de Equipe:
Se os valores forem restritos e você não tiver acesso, use o seguinte parâmetro na sua solicitação:
“amountShown”: “HIDE_AMOUNT”
Isso gerará o relatório sem incluir os dados financeiros.
401 – Não Autorizado #
Este erro significa que a autenticação falhou, geralmente porque a chave de API está ausente, é inválida ou não está autorizada a acessar a fonte solicitada.
Por que isso acontece:
- A chave de API está ausente, é inválida ou foi passada incorretamente no cabeçalho
- A chave de API está associada a um usuário que não tem acesso ao endpoint
- O plano de assinatura atual não oferece suporte ao recurso solicitado
Como corrigir:
- Verifique se a chave de API está incluída corretamente
X-Api-Key: your_api_key
- Verifique se a chave de API é válida:
- Clique na sua foto de perfil e selecione Preferências
- Abra a aba Avançado
- Clique em Gerar para criar uma nova chave de API
- Garanta as permissões corretas
O usuário vinculado à chave de API deve ter acesso ao espaço de trabalho, projeto ou recurso solicitado.
- Verifique seu plano novamente:
Alguns endpoints de API estão disponíveis apenas em planos pagos, como "Adicionar tempo para outros", por exemplo.
400 – Token ou chave de API obrigatórios e 1000 – Autenticação completa necessária #
Este erro aparece quando a solicitação não possui um cabeçalho de autenticação, o que significa que o sistema não sabe quem está fazendo a solicitação.
Por que isso acontece:
- A chamada de API não possui a X-Api-Key nos cabeçalhos
- A solicitação pode ter sido enviada de um script ou ferramenta que não incluiu as informações de autenticação corretamente
Como corrigir:
Inclua o seguinte cabeçalho na sua solicitação:
X-Api-Key: your_api_key
Ainda com problemas? A equipe de suporte do Clockify terá prazer em analisar e ajudar você. Entre em contato conosco pelo e-mail support@clockify.me e inclua as seguintes informações:
- Uma captura de tela da solicitação e da resposta que você está recebendo
- Informações sobre sua função no ambiente de trabalho
- Uma captura de tela da mensagem de erro que você vê na resposta