Descifrando la jerga de Transloadit: una guía completa
¿Eres nuevo en Transloadit y te sientes perdido en el mar de términos técnicos? No te preocupes, ¡te tenemos cubierto! En esta entrada repasaremos parte de la jerga específica de Transloadit, para que te sientas con confianza la próxima vez que navegues por la documentación de Transloadit.
Robots y Jobs
Internamente, Transloadit funciona ejecutando herramientas como FFmpeg sobre un archivo. Ejecutar una herramienta así crea un Job, que es la unidad lógica más pequeña sobre la que se construye todo lo demás.
Sin embargo, los Jobs no se ejecutan solos, y ahí es donde entran nuestros Robots. Cada Robot de nuestro arsenal está especializado en una única tarea, y existe un número interminable de posibles combinaciones de Robot que pueden crear funcionalidades complejas, como un generador de tarjetas musicales (English).
Templates, Assemblies y Assembly Instructions
Un Robot por sí solo ya puede hacer cosas impresionantes, pero cuando empezamos a unir varios Robots en una línea de montaje (o, como nos gusta decir, Assembly Instructions), podemos crear cosas realmente geniales. Cada Robot realiza un único Step del proceso, lo que en última instancia da como resultado una funcionalidad mayor que la suma de cualquiera de las partes individuales.
Los servidores de Transloadit pueden entonces analizar tus Assembly Instructions y ejecutar las herramientas de back-end necesarias para generar tus archivos transcodificados. Usamos el término Assembly para referirnos a una única ejecución de las Assembly Instructions.
Por supuesto, no siempre resulta ideal pasar un nuevo conjunto de Assembly Instructions cada vez que quieres crear una Assembly. Por eso creamos los Templates. Con los Templates, solo tienes que indicarle a Transloadit el nombre de tu Template, y nosotros seguiremos desde ahí tu receta JSON cuidadosamente elaborada. Describimos algunas de las ventajas de usar Templates en una entrada de blog reciente: 5 formas de sacar el máximo partido a Transloadit.
Síncrono vs. asíncrono
De forma predeterminada, Transloadit devuelve el estado actual de la Assembly como parte del Assembly Status JSON, al que puedes suscribirte y consultar periódicamente para comprobar si la Assembly ha finalizado. A esto se le llama usar Transloadit de forma síncrona o en Sync Mode.
Sin embargo, también ofrecemos la opción de interactuar con Transloadit de forma asíncrona.
Proporciona un notify_url y establece waitForEncoding en false, y enviaremos una solicitud POST a tu
back-end cuando la Assembly haya terminado la codificación. De este modo, tu usuario no
quedará bloqueado mientras tus servidores esperan a que termine la transcodificación. Puedes
obtener más información sobre cómo configurar el Async
Mode y verificar las firmas de notificación en nuestra
guía de webhooks.
Otra función útil, disponible independientemente del modo síncrono o asíncrono, son los Assembly Replays. Si hubo un problema al ejecutar tu Assembly y los archivos ya se habían subido correctamente, Transloadit puede reejecutar la Assembly en un plazo de 24 horas. Esto sucederá automáticamente en caso de un fallo del servidor, pero también se puede activar manualmente desde la Transloadit Console.
¡Y eso es todo, amigos!
Con esto llegamos al final de nuestro recorrido rápido por la terminología de Transloadit.
Esperamos que esta entrada haya aclarado cualquier confusión que pudieras tener. Como siempre, no dudes en escribirnos si necesitas orientación sobre cualquiera de las funciones de Transloadit.