Solução de problemas

Erros e problemas comuns

4 min de leitura

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:
  1. Clique na sua foto de perfil e selecione Preferências
  2. Abra a aba Avançado
  3. 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:
  1. Clique na sua foto de perfil e selecione Preferências 
  2. Abra a aba Avançado
  3. 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:

  1. Uma captura de tela da solicitação e da resposta que você está recebendo 
  2. Informações sobre sua função no ambiente de trabalho 
  3. Uma captura de tela da mensagem de erro que você vê na resposta

Esse artigo foi útil?

Thank you! If you’d like a member of our support team to respond to you, please drop us a note at support@clockify.me