Comment récupérer les pièces jointes de transition dans Zoho Desk

La récupération des pièces jointes de transition dans Zoho Desk nécessite une simple requête GET vers l'API REST de Desk, en fournissant à la fois l'identifiant du ticket et l'identifiant de la transition pour obtenir tous les fichiers joints à un brouillon de transition.

Pourquoi c'est important

Lorsqu'un ticket Zoho Desk progresse dans un blueprint ou un workflow, les agents peuvent joindre des documents justificatifs directement à un brouillon de transition. Si vous devez auditer ces fichiers, les afficher dans un portail personnalisé ou les traiter par programmation, vous devez savoir comment interroger le bon endpoint. Il s'agit également d'une étape préalable avant de décider de supprimer une pièce jointe spécifique d'un brouillon de transition.

Étape par étape

Étape 1. Vérifiez que vous disposez d'un jeton d'accès OAuth valide avec la portée Zoho Desk. Votre jeton doit être obtenu via le flux OAuth standard de Zoho — en échangeant un code d'autorisation contre un jeton d'accès — avant qu'un appel API puisse aboutir. ^[8]

Étape 2. Identifiez les deux identifiants clés dont vous aurez besoin : le ticketId du ticket concerné et le transitionId de la transition de blueprint spécifique dont vous souhaitez récupérer les pièces jointes. Les deux valeurs sont des chaînes de caractères et doivent être fournies dans le chemin de l'URL. ^[1]

Étape 3. Envoyez 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}/transitions/{transitionId}/attachments

Cette opération est documentée en interne sous le nom op15getattachmentof_transition et est décrite comme « Get Attachment of Transition Draft ». ^[1]

Étape 4. Vous pouvez éventuellement passer un paramètre p sous forme de dictionnaire en query string si vous devez appliquer des options de pagination ou de filtrage prises en charge par l'endpoint. Lorsqu'aucun paramètre supplémentaire n'est nécessaire, cet argument peut être omis ou défini sur None. ^[1]

Étape 5. En Python, le schéma d'appel ressemble à ceci :

result = client.op_15_get_attachment_of_transition(
    ticketId="123456",
    transitionId="789012",
    p=None  # or pass a dict of query params
)

La requête sous-jacente est un simple GET HTTP sans corps de requête. ^[1]

Étape 6. Analysez la réponse pour obtenir la liste des objets de pièces jointes associés à ce brouillon de transition. Chaque objet contiendra les métadonnées nécessaires pour identifier les pièces jointes individuelles — vous aurez besoin de la valeur attachmentId de cette réponse si vous souhaitez ultérieurement supprimer un fichier spécifique. ^[4]

Erreurs courantes

• Ordre des identifiants incorrect. Le chemin requiert ticketId en premier, puis transitionId. Les inverser entraînera une erreur 404 ou une réponse vide inattendue. Vérifiez l'ordre par rapport à la signature de l'endpoint. ^[1]
• Jeton OAuth expiré ou manquant. Tous les appels à l'API Zoho Desk nécessitent un jeton d'accès valide. Si votre jeton a expiré, renouvelez-le avant de réessayer — un jeton expiré retournera une erreur d'authentification plutôt que les données des pièces jointes. ^[8]
• Confusion entre « récupération » et « suppression ». L'endpoint de récupération (GET …/attachments) et l'endpoint de suppression (DELETE …/attachments/{attachmentId}) partagent le même chemin de base, mais diffèrent par la méthode HTTP et la présence de attachmentId. Utiliser la mauvaise méthode n'aura aucun effet ou supprimera définitivement un fichier. ^[4]

Points à vérifier

• Vérifiez que les deux identifiants sont corrects — confirmez que le ticketId et le transitionId existent dans votre organisation Zoho Desk avant d'effectuer l'appel, car un identifiant invalide retournera une erreur plutôt qu'une liste vide. ^[1]
• Confirmez que la réponse contient des métadonnées de pièces jointes — si le brouillon de transition ne comporte aucun fichier joint, le tableau de réponse sera vide ; il s'agit d'un comportement attendu, et non d'une erreur. ^[1]
• Notez les valeurs attachmentId — si des actions ultérieures telles que la suppression sont nécessaires, capturez ces identifiants depuis cette réponse dès maintenant, car l'opération de suppression les requiert explicitement. ^[4]

---

*Beam Help est une ressource d'assistance experte indépendante pour les produits Zoho et ne constitue pas le support officiel de Zoho. Testez toujours les appels API dans un environnement sandbox avant de les exécuter sur des données de production.*