Erreurs et problèmes courants
L’heure de début est supérieure à l’heure de fin #
Cette erreur se produit lorsque l’heure de début indiquée dans votre requête API est postérieure à l’heure de fin, souvent en raison d’un décalage entre les fuseaux horaires locaux et l’heure UTC, qui est celle attendue par l’API Clockify.
Pourquoi cela se produit-il :
- L’API Clockify utilise l’heure UTC pour toutes les valeurs basées sur le temps.
- Envoyer une heure de début en heure locale (p. ex. Bruxelles +1) sans la convertir en UTC peut entraîner une heure de début qui apparaît plus tard que l’heure de fin.
Comment résoudre ce problème :
- Assurez-vous que les heures de début et de fin indiquées dans votre requête sont converties en UTC
- Vérifiez soigneusement l’intégralité de la requête API :
- Point de terminaison utilisé
- Corps de la requête et champs de temps
- En-têtes (en particulier Content-Type et authentification)
- Paramètres de fuseau horaire sur le serveur ou le script générant la requête
Même si une heure de début non UTC est acceptée, le minuteur peut démarrer avec une durée négative, ce qui peut affecter les calculs et les rapports. La conversion en UTC résout complètement ce problème.
403 – Interdit #
Cette erreur signifie que votre demande est comprise par le serveur, mais que vous n’êtes pas autorisé à effectuer l’action en raison d’autorisations manquantes ou de restrictions de fonctionnalités.
Pourquoi cela se produit-il :
- La clé API utilisée ne dispose pas des autorisations nécessaires pour l’opération demandée
- Le rôle de l’utilisateur (p. ex. chef de projet ou chef d’équipe) dispose d’un accès limité
- L’abonnement ne comprend pas la fonctionnalité demandée
- Vous demandez un rapport contenant des montants, mais vous ne disposez pas des autorisations nécessaires pour les consulter
Comment résoudre ce problème :
- Vérifiez le rôle et les autorisations de l’utilisateur :
Assurez-vous que la clé API appartient à un utilisateur disposant du rôle et de l’accès appropriés à la ressource.
- Vérifiez l’abonnement :
Certaines fonctionnalités et certains points de terminaison nécessitent un abonnement payant, comme « Ajouter du temps pour les autres », par exemple.
- Régénérez votre clé API :
- Cliquez sur votre photo de profil et sélectionnez Préférences
- Ouvrez l’onglet Avancé
- Cliquez sur Générer à côté du champ Clé API
- Si vous générez un rapport en tant que chef de projet ou chef d’équipe :
Si les montants sont restreints et que vous n’y avez pas accès, utilisez le paramètre suivant dans votre demande :
“amountShown”: “HIDE_AMOUNT”
Cela générera le rapport sans inclure les données financières.
401 – Non autorisé #
Cette erreur signifie que l’authentification a échoué, généralement parce que la clé API est manquante, invalide ou non autorisée à accéder à la source demandée.
Pourquoi cela se produit-il :
- La clé API est manquante, invalide ou incorrectement transmise dans l’en-tête
- La clé API est associée à un utilisateur qui n’a pas accès au point de terminaison
- L’abonnement actuel ne prend pas en charge la fonctionnalité demandée
Comment résoudre ce problème :
- Vérifiez que la clé API est correctement incluse.
X-Api-Key: your_api_key
- Vérifiez que la clé API est valide :
- Cliquez sur votre photo de profil et sélectionnez Préférences
- Ouvrez l’onglet Avancé
- Cliquez sur Générer pour créer une nouvelle clé API
- Vérifiez que les autorisations sont correctes
L’utilisateur associé à la clé API doit avoir accès à l’espace de travail, au projet ou à la fonctionnalité demandés.
- Vérifiez bien votre abonnement :
Certaines fonctionnalités de l’API ne sont disponibles que dans les abonnements payants, comme « Ajouter du temps pour les autres », par exemple.
400 – Jeton ou clé API requis et 1000 – Authentification complète requise #
Cette erreur apparaît lorsque l’en-tête d’authentification est manquant dans la requête, ce qui signifie que le système ne sait pas qui effectue la requête.
Pourquoi cela se produit-il :
- L’appel API ne contient pas la clé X-Api-Key dans les en-têtes.
- La requête a peut-être été envoyée à partir d’un script ou d’un outil qui n’a pas correctement inclus les informations d’authentification.
Comment résoudre ce problème :
Incluez l’en-tête suivant dans votre requête :
X-Api-Key: your_api_key
Vous rencontrez toujours des difficultés ? Notre équipe d’assistance se fera un plaisir d’examiner votre cas et de vous aider. Veuillez nous contacter à l’adresse support@clockify.me et nous fournir les informations suivantes :
- Une capture d’écran de la requête et de la réponse que vous recevez
- Les informations sur votre rôle dans l’espace de travail
- Une capture d’écran du message d’erreur qui s’affiche dans la réponse