{"id":23846,"date":"2025-06-27T08:52:14","date_gmt":"2025-06-27T08:52:14","guid":{"rendered":"https:\/\/clockify.me\/help\/?p=23846"},"modified":"2026-01-16T13:38:19","modified_gmt":"2026-01-16T13:38:19","slug":"common-errors-and-issues","status":"publish","type":"post","link":"https:\/\/clockify.me\/help\/pt\/troubleshooting\/general-api-troubleshooting\/common-errors-and-issues","title":{"rendered":"Erros e problemas comuns"},"content":{"rendered":"<h2 class=\"wp-block-heading\">Hora de in\u00edcio \u00e9 posterior \u00e0 hora de t\u00e9rmino\u00a0<\/h2>\n\n\n\n<p>Este erro ocorre quando a hora de in\u00edcio na sua solicita\u00e7\u00e3o de API \u00e9 posterior \u00e0 hora de t\u00e9rmino, geralmente devido a uma incompatibilidade entre os fusos hor\u00e1rios locais e o UTC, que \u00e9 o esperado pela API do Clockify.&nbsp;<\/p>\n\n\n\n<p>Por que isso acontece:&nbsp;<\/p>\n\n\n\n<ul class=\"wp-block-list\">\n<li>A API do Clockify usa o hor\u00e1rio UTC para todos os valores baseados em tempo<\/li>\n\n\n\n<li>Enviar uma hora de in\u00edcio no hor\u00e1rio local (por exemplo, Bruxelas +1) sem convert\u00ea-la para UTC pode resultar em uma hora de in\u00edcio posterior \u00e0 hora de t\u00e9rmino\u00a0<\/li>\n<\/ul>\n\n\n\n<p>Como corrigir:&nbsp;<\/p>\n\n\n\n<ul class=\"wp-block-list\">\n<li>Certifique-se de que as horas de in\u00edcio e t\u00e9rmino na sua solicita\u00e7\u00e3o sejam convertidas para UTC.<\/li>\n\n\n\n<li>Verifique novamente a solicita\u00e7\u00e3o de API completa:\n<ul class=\"wp-block-list\">\n<li>Endpoint utilizado<\/li>\n\n\n\n<li>Corpo da requisi\u00e7\u00e3o e campos de hora<\/li>\n\n\n\n<li>Cabe\u00e7alhos (especialmente Content-Type e autentica\u00e7\u00e3o)<\/li>\n\n\n\n<li>Configura\u00e7\u00f5es de fuso hor\u00e1rio no servidor ou script que gera a requisi\u00e7\u00e3o<\/li>\n<\/ul>\n<\/li>\n<\/ul>\n\n\n\n<p class=\"note\">Mesmo que uma hora de in\u00edcio diferente de UTC seja aceita, o cron\u00f4metro pode come\u00e7ar com uma dura\u00e7\u00e3o negativa, o que pode afetar os c\u00e1lculos e os relat\u00f3rios. A convers\u00e3o para UTC resolve esse problema completamente.<\/p>\n\n\n\n<h2 class=\"wp-block-heading\">403 \u2013 Proibido<\/h2>\n\n\n\n<p>Este erro significa que sua solicita\u00e7\u00e3o foi entendida pelo servidor, mas voc\u00ea n\u00e3o est\u00e1 autorizado a executar a a\u00e7\u00e3o devido \u00e0 aus\u00eancia de permiss\u00f5es ou restri\u00e7\u00f5es de recursos.&nbsp;<\/p>\n\n\n\n<p>Por que isso acontece:<\/p>\n\n\n\n<ul class=\"wp-block-list\">\n<li>A chave de API em uso n\u00e3o tem permiss\u00e3o para a opera\u00e7\u00e3o solicitada<\/li>\n\n\n\n<li>A fun\u00e7\u00e3o do usu\u00e1rio (por exemplo, Gerente de Projeto ou Gerente de Equipe) tem acesso limitado<\/li>\n\n\n\n<li>O plano de assinatura n\u00e3o inclui o recurso solicitado<\/li>\n\n\n\n<li>Voc\u00ea est\u00e1 solicitando um relat\u00f3rio com valores, mas n\u00e3o tem permiss\u00e3o para visualiz\u00e1-los<\/li>\n<\/ul>\n\n\n\n<p>Como corrigir:&nbsp;<\/p>\n\n\n\n<ul class=\"wp-block-list\">\n<li>Verifique a fun\u00e7\u00e3o e as permiss\u00f5es do usu\u00e1rio:<\/li>\n<\/ul>\n\n\n\n<p>Certifique-se de que a chave de API perten\u00e7a a um usu\u00e1rio com a fun\u00e7\u00e3o e o acesso corretos ao recurso.<\/p>\n\n\n\n<ul class=\"wp-block-list\">\n<li>Verifique a assinatura:<\/li>\n<\/ul>\n\n\n\n<p>Alguns endpoints e recursos exigem um plano pago, como \"Adicionar tempo para outros\", por exemplo.&nbsp;<\/p>\n\n\n\n<ul class=\"wp-block-list\">\n<li>Regenere sua chave de API:<\/li>\n<\/ul>\n\n\n\n<ol class=\"wp-block-list\">\n<li>Clique na sua foto de perfil e selecione Prefer\u00eancias<\/li>\n\n\n\n<li>Abra a aba Avan\u00e7ado<\/li>\n\n\n\n<li>Clique em Gerenciar chaves API ao lado do campo API<\/li>\n<\/ol>\n\n\n\n<ul class=\"wp-block-list\">\n<li>Se estiver gerando um relat\u00f3rio como Gerente de Projeto ou de Equipe:<\/li>\n<\/ul>\n\n\n\n<p>Se os valores forem restritos e voc\u00ea n\u00e3o tiver acesso, use o seguinte par\u00e2metro na sua solicita\u00e7\u00e3o:<\/p>\n\n\n\n<p>\u201camountShown\u201d: \u201cHIDE_AMOUNT\u201d<\/p>\n\n\n\n<p>Isso gerar\u00e1 o relat\u00f3rio sem incluir os dados financeiros.&nbsp;<\/p>\n\n\n\n<h2 class=\"wp-block-heading\">401 \u2013 N\u00e3o Autorizado<\/h2>\n\n\n\n<p>Este erro significa que a autentica\u00e7\u00e3o falhou, geralmente porque a chave de API est\u00e1 ausente, \u00e9 inv\u00e1lida ou n\u00e3o est\u00e1 autorizada a acessar a fonte solicitada.&nbsp;<\/p>\n\n\n\n<p>Por que isso acontece:<\/p>\n\n\n\n<ul class=\"wp-block-list\">\n<li>A chave de API est\u00e1 ausente, \u00e9 inv\u00e1lida ou foi passada incorretamente no cabe\u00e7alho<\/li>\n\n\n\n<li>A chave de API est\u00e1 associada a um usu\u00e1rio que n\u00e3o tem acesso ao endpoint<\/li>\n\n\n\n<li>O plano de assinatura atual n\u00e3o oferece suporte ao recurso solicitado<\/li>\n<\/ul>\n\n\n\n<p>Como corrigir:&nbsp;<\/p>\n\n\n\n<ul class=\"wp-block-list\">\n<li>Verifique se a chave de API est\u00e1 inclu\u00edda corretamente<\/li>\n<\/ul>\n\n\n\n<p>X-Api-Key: your_api_key<\/p>\n\n\n\n<ul class=\"wp-block-list\">\n<li>Verifique se a chave de API \u00e9 v\u00e1lida:<\/li>\n<\/ul>\n\n\n\n<ol class=\"wp-block-list\">\n<li>Clique na sua foto de perfil e selecione Prefer\u00eancias\u00a0<\/li>\n\n\n\n<li>Abra a aba Avan\u00e7ado<\/li>\n\n\n\n<li>Clique em Gerar para criar uma nova chave de API<\/li>\n<\/ol>\n\n\n\n<ul class=\"wp-block-list\">\n<li>Garanta as permiss\u00f5es corretas\u00a0<\/li>\n<\/ul>\n\n\n\n<p>O usu\u00e1rio vinculado \u00e0 chave de API deve ter acesso ao espa\u00e7o de trabalho, projeto ou recurso solicitado.&nbsp;<\/p>\n\n\n\n<ul class=\"wp-block-list\">\n<li>Verifique seu plano novamente:<\/li>\n<\/ul>\n\n\n\n<p>Alguns endpoints de API est\u00e3o dispon\u00edveis apenas em planos pagos, como \"Adicionar tempo para outros\", por exemplo.<\/p>\n\n\n\n<h2 class=\"wp-block-heading\">400 \u2013 Token ou chave de API obrigat\u00f3rios e 1000 \u2013 Autentica\u00e7\u00e3o completa necess\u00e1ria<\/h2>\n\n\n\n<p>Este erro aparece quando a solicita\u00e7\u00e3o n\u00e3o possui um cabe\u00e7alho de autentica\u00e7\u00e3o, o que significa que o sistema n\u00e3o sabe quem est\u00e1 fazendo a solicita\u00e7\u00e3o.<\/p>\n\n\n\n<p>Por que isso acontece:&nbsp;<\/p>\n\n\n\n<ul class=\"wp-block-list\">\n<li>A chamada de API n\u00e3o possui a X-Api-Key nos cabe\u00e7alhos<\/li>\n\n\n\n<li>A solicita\u00e7\u00e3o pode ter sido enviada de um script ou ferramenta que n\u00e3o incluiu as informa\u00e7\u00f5es de autentica\u00e7\u00e3o corretamente<\/li>\n<\/ul>\n\n\n\n<p>Como corrigir:<\/p>\n\n\n\n<p>Inclua o seguinte cabe\u00e7alho na sua solicita\u00e7\u00e3o:<\/p>\n\n\n\n<p>X-Api-Key: your_api_key&nbsp;<\/p>\n\n\n\n<p>Ainda com problemas? A equipe de suporte do Clockify ter\u00e1 prazer em analisar e ajudar voc\u00ea. Entre em contato conosco pelo e-mail support@clockify.me e inclua as seguintes informa\u00e7\u00f5es:<\/p>\n\n\n\n<ol class=\"wp-block-list\">\n<li>Uma captura de tela da solicita\u00e7\u00e3o e da resposta que voc\u00ea est\u00e1 recebendo\u00a0<\/li>\n\n\n\n<li>Informa\u00e7\u00f5es sobre sua fun\u00e7\u00e3o no ambiente de trabalho\u00a0<\/li>\n\n\n\n<li>Uma captura de tela da mensagem de erro que voc\u00ea v\u00ea na resposta<\/li>\n<\/ol>","protected":false},"excerpt":{"rendered":"Start time is greater than end time\u00a0 This error occurs when the start time in y&#8230;","protected":false},"author":41,"featured_media":0,"comment_status":"closed","ping_status":"closed","sticky":false,"template":"","format":"standard","meta":{"_acf_changed":false,"_helpful_status":1,"_searchwp_excluded":"","footnotes":""},"categories":[73],"tags":[],"class_list":["post-23846","post","type-post","status-publish","format-standard","hentry","category-general-api-troubleshooting"],"acf":[],"featured_image_src":null,"author_info":{"display_name":"Milena Dimic Vlajic","author_link":"https:\/\/clockify.me\/help\/pt\/author\/millenaclockify-me"},"_links":{"self":[{"href":"https:\/\/clockify.me\/help\/pt\/wp-json\/wp\/v2\/posts\/23846","targetHints":{"allow":["GET"]}}],"collection":[{"href":"https:\/\/clockify.me\/help\/pt\/wp-json\/wp\/v2\/posts"}],"about":[{"href":"https:\/\/clockify.me\/help\/pt\/wp-json\/wp\/v2\/types\/post"}],"author":[{"embeddable":true,"href":"https:\/\/clockify.me\/help\/pt\/wp-json\/wp\/v2\/users\/41"}],"replies":[{"embeddable":true,"href":"https:\/\/clockify.me\/help\/pt\/wp-json\/wp\/v2\/comments?post=23846"}],"version-history":[{"count":2,"href":"https:\/\/clockify.me\/help\/pt\/wp-json\/wp\/v2\/posts\/23846\/revisions"}],"predecessor-version":[{"id":23848,"href":"https:\/\/clockify.me\/help\/pt\/wp-json\/wp\/v2\/posts\/23846\/revisions\/23848"}],"wp:attachment":[{"href":"https:\/\/clockify.me\/help\/pt\/wp-json\/wp\/v2\/media?parent=23846"}],"wp:term":[{"taxonomy":"category","embeddable":true,"href":"https:\/\/clockify.me\/help\/pt\/wp-json\/wp\/v2\/categories?post=23846"},{"taxonomy":"post_tag","embeddable":true,"href":"https:\/\/clockify.me\/help\/pt\/wp-json\/wp\/v2\/tags?post=23846"}],"curies":[{"name":"wp","href":"https:\/\/api.w.org\/{rel}","templated":true}]}}