{"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\/de\/troubleshooting\/general-api-troubleshooting\/common-errors-and-issues","title":{"rendered":"H\u00e4ufige Fehler und Probleme"},"content":{"rendered":"<h2 class=\"wp-block-heading\">Startzeit liegt nach Endzeit\u00a0<\/h2>\n\n\n\n<p>Dieser Fehler tritt auf, wenn die Startzeit in deiner API-Anfrage nach der Endzeit liegt. Dies ist h\u00e4ufig auf eine Diskrepanz zwischen lokalen Zeitzonen und der UTC-Zeit zur\u00fcckzuf\u00fchren, die von der Clockify-API erwartet wird.&nbsp;<\/p>\n\n\n\n<p>Ursache des Fehlers:&nbsp;<\/p>\n\n\n\n<ul class=\"wp-block-list\">\n<li>Die Clockify API verwendet UTC-Zeit f\u00fcr alle zeitbasierten Werte<\/li>\n\n\n\n<li>Wenn du eine Startzeit in deiner lokalen Zeitzone (z. B. Berlin +2) sendest, ohne diese in UTC umzuwandeln, kann dies dazu f\u00fchren, dass die Startzeit sp\u00e4ter als die Endzeit erscheint.\u00a0<\/li>\n<\/ul>\n\n\n\n<p>L\u00f6sung des Problems:&nbsp;<\/p>\n\n\n\n<ul class=\"wp-block-list\">\n<li>Stelle sicher, dass sowohl die Start- als auch die Endzeit in deiner Anfrage in UTC konvertiert wurden.<\/li>\n\n\n\n<li>\u00dcberpr\u00fcfe die gesamte API-Anfrage sorgf\u00e4ltig:\n<ul class=\"wp-block-list\">\n<li>Verwendeter Endpunkt<\/li>\n\n\n\n<li>Request Body und Zeitfelder<\/li>\n\n\n\n<li>Header (insbesondere Content-Type und Authentifizierung)<\/li>\n\n\n\n<li>Zeitzonen-Einstellungen auf dem Server oder im Skript, das die Anfrage generiert<\/li>\n<\/ul>\n<\/li>\n<\/ul>\n\n\n\n<p class=\"note\">Selbst wenn eine Nicht-UTC-Startzeit akzeptiert wird, beginnt der Timer m\u00f6glicherweise mit einer negativen Dauer, was Berechnungen und Berichte beeintr\u00e4chtigen kann. Die Konvertierung in UTC behebt dieses Problem vollst\u00e4ndig.<\/p>\n\n\n\n<h2 class=\"wp-block-heading\">403 \u2013 Forbidden (Verboten)<\/h2>\n\n\n\n<p>Dieser Fehler bedeutet, dass deine Anfrage vom Server zwar verstanden wurde, du aber aufgrund fehlender Berechtigungen oder Funktionseinschr\u00e4nkungen nicht autorisiert bist, die Aktion auszuf\u00fchren.&nbsp;<\/p>\n\n\n\n<p>Ursache des Fehlers:<\/p>\n\n\n\n<ul class=\"wp-block-list\">\n<li>Der verwendete API-Schl\u00fcssel hat keine Berechtigung f\u00fcr die angeforderte Operation<\/li>\n\n\n\n<li>Die Rolle des Benutzers (z. B. Projektmanager oder Teammanager) hat einen eingeschr\u00e4nkten Zugriff<\/li>\n\n\n\n<li>Dein Abonnementplan beinhaltet die angeforderte Funktion nicht<\/li>\n\n\n\n<li>Du forderst einen Bericht mit Betr\u00e4gen an, hast aber keine Berechtigung, Betr\u00e4ge einzusehen<\/li>\n<\/ul>\n\n\n\n<p>L\u00f6sung des Problems:&nbsp;<\/p>\n\n\n\n<ul class=\"wp-block-list\">\n<li>Benutzerrolle und Berechtigungen pr\u00fcfen:<\/li>\n<\/ul>\n\n\n\n<p>Stelle sicher, dass der API-Schl\u00fcssel zu einem Benutzer mit der korrekten Rolle und dem Zugriff auf die Ressource geh\u00f6rt.<\/p>\n\n\n\n<ul class=\"wp-block-list\">\n<li>Abonnement \u00fcberpr\u00fcfen:<\/li>\n<\/ul>\n\n\n\n<p>Einige Endpunkte und Funktionen erfordern einen kostenpflichtigen Plan, wie zum Beispiel \u201eZeit f\u00fcr andere hinzuf\u00fcgen\u201c.&nbsp;<\/p>\n\n\n\n<ul class=\"wp-block-list\">\n<li>API-Schl\u00fcssel neu generieren:<\/li>\n<\/ul>\n\n\n\n<ol class=\"wp-block-list\">\n<li>Klicke auf dein Profilbild und w\u00e4hle <strong>Einstellungen<\/strong><\/li>\n\n\n\n<li>\u00d6ffne die Registerkarte <strong>Erweitert<\/strong><\/li>\n\n\n\n<li>Klicke auf <strong>Generieren<\/strong> neben dem Feld <strong>API-Schl\u00fcssel<\/strong><\/li>\n<\/ol>\n\n\n\n<ul class=\"wp-block-list\">\n<li>Wenn du einen Bericht als Projekt- oder Teammanager generierst:<\/li>\n<\/ul>\n\n\n\n<p>Wenn Betr\u00e4ge eingeschr\u00e4nkt sind und du keinen Zugriff hast, verwende den folgenden Parameter in deiner Anfrage:<\/p>\n\n\n\n<p>\u201camountShown\u201d: \u201cHIDE_AMOUNT\u201d<\/p>\n\n\n\n<p>Dadurch wird der Bericht generiert, ohne finanzielle Daten einzuschlie\u00dfen.&nbsp;<\/p>\n\n\n\n<h2 class=\"wp-block-heading\">401 \u2013 Unauthorized (Nicht authorisiert)<\/h2>\n\n\n\n<p>Dieser Fehler bedeutet, dass die Authentifizierung fehlgeschlagen ist. Dies liegt in der Regel daran, dass der API-Schl\u00fcssel fehlt, ung\u00fcltig ist oder nicht f\u00fcr den Zugriff auf die angeforderte Quelle autorisiert ist.&nbsp;<\/p>\n\n\n\n<p>Ursache des Fehlers:<\/p>\n\n\n\n<ul class=\"wp-block-list\">\n<li>Der verwendete API-Schl\u00fcssel hat keine Berechtigung f\u00fcr die angeforderte Operation<\/li>\n\n\n\n<li>Der API-Schl\u00fcssel geh\u00f6rt zu einem Benutzer, der keinen Zugriff auf den Endpunkt hat<\/li>\n\n\n\n<li>Der aktuelle Abonnementplan unterst\u00fctzt die angeforderte Funktion nicht<\/li>\n<\/ul>\n\n\n\n<p>L\u00f6sung des Problems:&nbsp;<\/p>\n\n\n\n<ul class=\"wp-block-list\">\n<li>\u00dcberpr\u00fcfe, ob der API-Schl\u00fcssel korrekt enthalten ist:<\/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>\u00dcberpr\u00fcfe, ob der API-Schl\u00fcssel g\u00fcltig ist:<\/li>\n<\/ul>\n\n\n\n<ol class=\"wp-block-list\">\n<li>Klicke auf dein <strong>Profilbild<\/strong> und w\u00e4hle <strong>Einstellungen<\/strong> aus\u00a0<\/li>\n\n\n\n<li>\u00d6ffne die Registerkarte <strong>Erweitert<\/strong><\/li>\n\n\n\n<li>Klicke auf <strong>Generieren<\/strong>, um einen neuen API-Schl\u00fcssel zu erstellen<\/li>\n<\/ol>\n\n\n\n<ul class=\"wp-block-list\">\n<li>Stelle korrekte Berechtigungen sicher\u00a0<\/li>\n<\/ul>\n\n\n\n<p>Der Benutzer, der mit dem API-Schl\u00fcssel verkn\u00fcpft ist, muss Zugriff auf den angeforderten Arbeitsbereich, das Projekt oder die Funktion haben.&nbsp;<\/p>\n\n\n\n<ul class=\"wp-block-list\">\n<li>\u00dcberpr\u00fcfe deinen Plan:<\/li>\n<\/ul>\n\n\n\n<p>Einige API-Endpunkte sind nur in kostenpflichtigen Pl\u00e4nen verf\u00fcgbar, wie zum Beispiel \u201eZeit f\u00fcr andere hinzuf\u00fcgen\u201c.<\/p>\n\n\n\n<h2 class=\"wp-block-heading\">400 \u2013 Required token or API key (Token oder API-Schl\u00fcssel erforderlich) und 1000 \u2013 Full authentication required (Vollst\u00e4ndige Authentifizierung erforderlich)<\/h2>\n\n\n\n<p>Dieser Fehler tritt auf, wenn in der Anfrage ein Authentifizierungs-Header fehlt. Das bedeutet, dass das System nicht wei\u00df, wer die Anfrage stellt.<\/p>\n\n\n\n<p>Ursache des Fehlers:&nbsp;<\/p>\n\n\n\n<ul class=\"wp-block-list\">\n<li>Dem API-Aufruf fehlt der X-Api-Key im Header<\/li>\n\n\n\n<li>Die Anfrage wurde m\u00f6glicherweise von einem Skript oder Tool gesendet, das die Authentifizierungsinformationen nicht korrekt \u00fcbermittelt hat<\/li>\n<\/ul>\n\n\n\n<p>L\u00f6sung des Problems:<\/p>\n\n\n\n<p>F\u00fcge den folgenden Header zu deiner Anfrage hinzu:<\/p>\n\n\n\n<p>X-Api-Key: your_api_key&nbsp;<\/p>\n\n\n\n<p>Hast du immer noch Probleme? Das Clockify-Support-Team hilft dir gerne weiter. Bitte kontaktiere uns unter <a href=\"mailto:support@clockify.me\">support@clockify.me<\/a> mit den folgenden Informationen:<\/p>\n\n\n\n<ol class=\"wp-block-list\">\n<li>Ein Screenshot der Anfrage und der Antwort, die du erh\u00e4ltst\u00a0<\/li>\n\n\n\n<li>Deine Rolle im Arbeitsbereich\u00a0<\/li>\n\n\n\n<li>Ein Screenshot der Fehlermeldung, die du in der Antwort siehst<\/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\/de\/author\/millenaclockify-me"},"_links":{"self":[{"href":"https:\/\/clockify.me\/help\/de\/wp-json\/wp\/v2\/posts\/23846","targetHints":{"allow":["GET"]}}],"collection":[{"href":"https:\/\/clockify.me\/help\/de\/wp-json\/wp\/v2\/posts"}],"about":[{"href":"https:\/\/clockify.me\/help\/de\/wp-json\/wp\/v2\/types\/post"}],"author":[{"embeddable":true,"href":"https:\/\/clockify.me\/help\/de\/wp-json\/wp\/v2\/users\/41"}],"replies":[{"embeddable":true,"href":"https:\/\/clockify.me\/help\/de\/wp-json\/wp\/v2\/comments?post=23846"}],"version-history":[{"count":2,"href":"https:\/\/clockify.me\/help\/de\/wp-json\/wp\/v2\/posts\/23846\/revisions"}],"predecessor-version":[{"id":23848,"href":"https:\/\/clockify.me\/help\/de\/wp-json\/wp\/v2\/posts\/23846\/revisions\/23848"}],"wp:attachment":[{"href":"https:\/\/clockify.me\/help\/de\/wp-json\/wp\/v2\/media?parent=23846"}],"wp:term":[{"taxonomy":"category","embeddable":true,"href":"https:\/\/clockify.me\/help\/de\/wp-json\/wp\/v2\/categories?post=23846"},{"taxonomy":"post_tag","embeddable":true,"href":"https:\/\/clockify.me\/help\/de\/wp-json\/wp\/v2\/tags?post=23846"}],"curies":[{"name":"wp","href":"https:\/\/api.w.org\/{rel}","templated":true}]}}