Presentamos USER_COMMAND_ERROR para entender mejor los errores
Además del ya existente INTERNAL_COMMAND_ERROR, nuestra API ahora puede devolver un nuevo
código de error: USER_COMMAND_ERROR. Esto permite distinguir mejor si un error fue
causado por una entrada incorrecta del usuario o por un contratiempo interno de Transloadit. Esta
mejora te permite identificar y resolver rápidamente los problemas ligados a las instrucciones
específicas que se proporcionaron, lo que garantiza una experiencia más fluida en general.
A pesar de nuestros mejores esfuerzos, no todas las operaciones de transcodificación terminarán correctamente. En esos casos, las Assemblies terminan con error y se marcan como fallidas. Normalmente, los fallos se deben a una de estas tres razones:
- El archivo proporcionado está mal formado o dañado, por ejemplo, un archivo de imagen al que le faltan los últimos bytes.
- Las instrucciones proporcionadas contienen errores, por ejemplo, no incluir una contraseña para un documento PDF cifrado.
- El archivo y las instrucciones proporcionados son correctos, pero un contratiempo interno hizo que la operación fallara.
Antes, en todos esos casos, la Assembly terminaba con el estado de error
INTERNAL_COMMAND_ERROR. Sin embargo, este estado hace que sea difícil, tanto para nuestros
usuarios como para nosotros en calidad de operadores del servicio, distinguir entre los errores
causados por archivos o instrucciones mal formados y los causados por errores internos. Esa
distinción es importante para que nuestros usuarios determinen qué errores pueden resolver por su
cuenta, y a la vez nos permite centrarnos en corregir los problemas internos lo más rápido posible.
¿Qué cambiará?
A partir de ahora, los errores causados por archivos mal formados o instrucciones erróneas harán
que la Assembly falle con el nuevo estado USER_COMMAND_ERROR. Esto indica que surgió
un problema que los propios usuarios pueden solucionar, por ejemplo, corrigiendo las Assembly
Instructions.
Las Assemblies que fallen debido a contratiempos internos de Transloadit se seguirán
marcando con el estado INTERNAL_COMMAND_ERROR, lo que nos permite investigar y resolver el
problema lo antes posible.
¿Qué significa esto para los usuarios?
La mayoría de los usuarios no tienen que hacer nada en cuanto a su integración. Solo tienes que
actuar si tu código de integración con Transloadit comprueba el estado
INTERNAL_COMMAND_ERROR, por ejemplo, para registrar eventos o iniciar reintentos. En esos
casos, también es aconsejable tener en cuenta el nuevo estado USER_COMMAND_ERROR.
Como siempre, nuestro equipo de soporte está aquí para ayudarte con cualquier duda o inquietud. No dudes en contactarnos, y con gusto te guiaremos a través de estos cambios.