Comment récupérer une approbation dans Zoho Desk

La récupération d'un enregistrement d'approbation dans Zoho Desk nécessite l'identifiant du ticket et l'identifiant de l'approbation — une fois ces deux éléments en main, une seule requête GET renvoie l'intégralité des détails de l'approbation.

Pourquoi c'est important

Les workflows d'approbation dans Zoho Desk permettent aux agents et aux responsables de conditionner l'avancement des tickets à des validations formelles. Si vous devez auditer une décision d'approbation, afficher son statut actuel dans un tableau de bord externe, ou injecter des données d'approbation dans une automatisation en aval, vous devez être en mesure de récupérer cet enregistrement d'approbation spécifique par programmation. Connaître le bon endpoint et les paramètres requis vous fait gagner du temps et évite des requêtes de liste inutiles.

Étape par étape

Étape 1. Vérifiez que les scopes OAuth appropriés sont activés pour votre intégration Zoho Desk. Votre token doit au minimum inclure Desk.tickets.READ afin que les sous-ressources au niveau du ticket, telles que les approbations, soient accessibles. ^[5]

Étape 2. Identifiez les deux paramètres de chemin requis avant d'effectuer tout appel :

• ticketId — l'identifiant unique du ticket auquel appartient l'approbation.
• approvalId — l'identifiant unique de l'enregistrement d'approbation spécifique que vous souhaitez récupérer.

Ces deux valeurs sont des chaînes de caractères et doivent être présentes ; l'endpoint ne peut pas être résolu sans elles. ^[8]

Étape 3. Effectuez une requête GET vers l'endpoint suivant, en remplaçant les espaces réservés par vos valeurs réelles :

GET /api/v1/tickets/{ticketId}/approvals/{approvalId}

Par exemple, si l'identifiant de votre ticket est 123456 et l'identifiant de votre approbation est 789, le chemin résolu devient /api/v1/tickets/123456/approvals/789. ^[8]

Étape 4. Transmettez votre token d'accès OAuth dans l'en-tête Authorization. Si votre token a expiré, le client doit échanger le refresh token stocké contre un nouveau token d'accès avant de relancer la requête. ^[3]

Étape 5. Fournissez éventuellement des paramètres de requête supplémentaires via le dictionnaire p (par exemple, des filtres de champs ou des indications de pagination pris en charge par l'API Zoho Desk). Si vous n'avez pas de paramètres supplémentaires, transmettez un objet vide ou omettez-le entièrement. ^[8]

Étape 6. Traitez la réponse. Un appel réussi renvoie l'objet d'approbation au format JSON. Si la réponse contient une clé "error", affichez ce message à l'utilisateur ou consignez-le pour le débogage avant de relancer la requête. ^[2]

---

> Remarque : Beam Help est un service d'assistance expert indépendant pour Zoho — nous ne sommes pas le support officiel de Zoho. Vérifiez toujours le comportement des endpoints par rapport à votre centre de données Zoho Desk et à la version d'API spécifiques.

Erreurs courantes

• Identifiants manquants ou inversés. Passer l'identifiant d'approbation à la place de l'identifiant du ticket (ou inversement) renverra une erreur 404 ou un enregistrement sans rapport. Vérifiez bien l'ordre : l'identifiant du ticket vient en premier dans le chemin, l'identifiant de l'approbation en second. ^[8]
• Scope OAuth insuffisant. Si votre application connectée a été autorisée sans Desk.tickets.READ, l'API rejettera la requête avec une erreur de permissions. Réautorisez le flux OAuth en incluant les scopes corrects. ^[5]
• Token d'accès expiré. Les tokens d'accès Zoho ont une durée de vie limitée. Assurez-vous que votre intégration actualise automatiquement le token à l'aide du refresh token stocké lorsqu'une réponse 401 est reçue. ^[3]
• Identifiant d'organisation non défini. Les appels à l'API Zoho Desk sont limités à une organisation. Si l'en-tête orgId est absent ou incorrect, les requêtes peuvent échouer ou renvoyer des données provenant d'un mauvais portail. Vérifiez que l'identifiant d'organisation est résolu et joint à chaque requête. ^[7]

Points à vérifier

• Vérifiez que les valeurs ticketId et approvalId que vous utilisez existent bien dans votre portail Zoho Desk avant d'appeler l'endpoint. ^[8]
• Confirmez que votre token OAuth inclut Desk.tickets.READ et qu'il n'a pas expiré avant d'effectuer la requête. ^[5]
• Inspectez la réponse JSON pour détecter un champ "error" et gérez-le correctement dans votre logique d'intégration avant toute tentative de traitement ultérieur. ^[2]