Comment supprimer les paramètres de suivi du temps dans Zoho Desk

La suppression des paramètres de suivi du temps dans Zoho Desk s'effectue via un unique appel API DELETE vers le point de terminaison des paramètres de suivi du temps — aucun corps de requête n'est nécessaire, hormis d'éventuels paramètres de requête optionnels.

Pourquoi c'est important

Si votre équipe support a configuré des règles de suivi du temps qui ne sont plus pertinentes — par exemple, après un changement de modèle de facturation ou une restructuration départementale — vous pourriez avoir besoin d'effacer entièrement ces paramètres plutôt que de simplement les mettre à jour. Connaître le bon point de terminaison et le scope OAuth requis vous évite de perdre du temps en débogage et d'obtenir des erreurs de permission accidentelles. Cela est particulièrement utile pour les développeurs qui automatisent la gestion de la configuration de Zoho Desk via des scripts ou des pipelines CI.

Étape par étape

Étape 1. Vérifiez que votre token OAuth inclut le scope Zoho Desk correct avant d'effectuer tout appel API lié aux paramètres. Le scope dont vous avez besoin est Desk.settings.DELETE (ou le scope plus large Desk.settings.ALL). Sans ce scope dans votre token, la requête sera rejetée au niveau de la couche d'autorisation. ^[2]

Étape 2. Assurez-vous que votre client est initialisé avec un token d'accès valide et le bon orgId pour votre organisation Zoho Desk. Si l'orgId est absent ou obsolète, la couche API ne peut pas acheminer la requête vers le bon portail. Vous pouvez récupérer l'identifiant de votre organisation en appelant le point de terminaison de la liste des organisations et en lisant le champ id du premier résultat. ^[7]

Étape 3. Envoyez une requête DELETE vers le point de terminaison suivant :

DELETE /api/v1/timetracking/settings

Aucun corps JSON n'est nécessaire. Vous pouvez transmettre des paramètres de requête optionnels via le dictionnaire p si votre couche d'intégration le prend en charge. ^[1]

Étape 4. Si vous utilisez le wrapper Python qui encapsule le client Zoho Desk, appelez la méthode comme indiqué ci-dessous :

response = api.delete_time_track_settings(p=None)

Passez un dictionnaire à p uniquement si vous devez fournir des paramètres de chaîne de requête ; sinon, None est acceptable. ^[1]

Étape 5. Examinez le code de statut HTTP de la réponse. Une suppression réussie retournera un statut 2xx. Si vous recevez une erreur 4xx, vérifiez à nouveau vos scopes OAuth (Étape 1) et la configuration de votre orgId (Étape 2). Si vous recevez une erreur 5xx, le problème provient du côté serveur de Zoho Desk et peut être transitoire — réessayez avec un délai exponentiel.

Étape 6. Si vous souhaitez uniquement modifier des paramètres de suivi du temps spécifiques plutôt que de les supprimer entièrement, utilisez PATCH /api/v1/timetracking/settings avec un payload de données à la place. Il s'agit de l'opération de mise à jour, qui accepte à la fois un corps data et des paramètres de requête optionnels p. ^[5]

Erreurs courantes

• Scope manquant : La cause la plus fréquente d'une réponse 403 Forbidden est un token OAuth généré sans Desk.settings.DELETE. Réautorisez le flux OAuth et incluez explicitement ce scope (ou Desk.settings.ALL) dans votre chaîne de scopes. ^[2][3]
• orgId incorrect ou manquant : Zoho Desk gère plusieurs organisations. Si l'en-tête orgId est absent ou incorrect, l'API ne peut pas identifier les paramètres de quel portail supprimer. Découvrez et persistez toujours l'orgId depuis le point de terminaison des organisations avant d'effectuer des appels liés aux paramètres. ^[7]
• Confusion entre DELETE et PATCH : L'appel DELETE supprime la configuration des paramètres de suivi du temps, tandis que PATCH /api/v1/timetracking/settings la met à jour. Assurez-vous d'utiliser le bon verbe selon votre intention. ^[1][5]

Points à vérifier

• Vérification du scope : Confirmez que Desk.settings.DELETE ou Desk.settings.ALL apparaît dans la liste des scopes du token OAuth actif avant d'exécuter l'appel. ^[2]
• Présence de l'orgId : Vérifiez que votre client Zoho Desk est initialisé avec une chaîne orgId non vide, récupérée depuis le point de terminaison des organisations si elle n'est pas déjà enregistrée. ^[7]
• Statut de la réponse : Après l'appel DELETE, vérifiez que le code de statut HTTP est dans la plage 2xx pour confirmer que les paramètres ont bien été supprimés. ^[1]

---

*Beam Help fournit une assistance experte indépendante pour les produits Zoho. Nous ne sommes pas le support officiel de Zoho — pour les problèmes au niveau de la plateforme, veuillez également contacter Zoho directement.*