Présentation de USER_COMMAND_ERROR pour mieux cerner les erreurs
En plus du code INTERNAL_COMMAND_ERROR déjà existant, notre API peut désormais renvoyer
un nouveau code d’erreur : USER_COMMAND_ERROR. Cela permet de mieux distinguer les erreurs
causées par des entrées incorrectes fournies par l’utilisateur de celles dues à un incident interne
à Transloadit. Cette amélioration vous permet d’identifier et de résoudre rapidement les problèmes
liés aux instructions précises fournies, assurant ainsi une expérience globalement plus fluide.
Malgré tous nos efforts, les opérations de transcodage ne réussissent pas toujours. Dans ces cas, les Assemblies rencontrent une erreur et sont marquées comme ayant échoué. Généralement, les échecs ont l’une des trois causes suivantes :
- Le fichier fourni est mal formé ou corrompu, par exemple un fichier image auquel il manque les derniers octets.
- Les instructions fournies contiennent des erreurs, par exemple l’absence de mot de passe pour un document PDF chiffré.
- Le fichier et les instructions fournis sont corrects, mais un incident interne a fait échouer l’opération.
Auparavant, dans tous ces cas, l’Assembly se terminait avec le statut d’erreur
INTERNAL_COMMAND_ERROR. Toutefois, ce statut permet difficilement à nos utilisateurs – et à nous,
en tant qu’exploitants du service – de distinguer les erreurs dues à des fichiers mal formés ou à des
instructions incorrectes de celles dues à des erreurs internes. Cette distinction est importante
pour que nos utilisateurs puissent déterminer quelles erreurs ils peuvent corriger eux-mêmes,
tandis qu’elle nous permet de nous concentrer sur la résolution des problèmes internes aussi
rapidement que possible.
Qu’est-ce qui va changer ?
Désormais, les erreurs causées par des fichiers mal formés ou des instructions incorrectes feront
échouer l’Assembly avec le nouveau statut USER_COMMAND_ERROR. Ce statut indique qu’un problème
est survenu et que les utilisateurs peuvent le résoudre eux-mêmes, par exemple en corrigeant les Assembly
Instructions.
Les Assemblies qui échouent à cause d’incidents internes à Transloadit conserveront le
statut INTERNAL_COMMAND_ERROR, ce qui nous permettra d’examiner et de résoudre le problème aussi
rapidement que possible.
Qu’est-ce que cela signifie pour les utilisateurs ?
La plupart des utilisateurs n’ont aucune modification à apporter à leur intégration. Vous ne devez
intervenir que si votre code d’intégration avec Transloadit vérifie le statut
INTERNAL_COMMAND_ERROR, par exemple pour consigner des événements ou lancer de nouvelles
tentatives. Dans ces cas, il est également conseillé de prendre en compte le nouveau statut
USER_COMMAND_ERROR.
Comme toujours, notre équipe d’assistance est à votre disposition pour toute question ou préoccupation. N’hésitez pas à nous contacter, et nous vous accompagnerons avec plaisir dans ces changements.