¿Qué es un Template?
Un Template almacena de forma segura Assembly Instructions de Transloadit en un Workspace y se referencia en las solicitudes a la API mediante un template_id. Permite que los clientes invoquen un flujo de procesamiento predefinido sin enviar todas sus Instructions.
Cómo funcionan los Templates
Un Template de Transloadit es una definición de flujo de trabajo gestionada desde un Workspace. Su JSON describe Assembly Steps con nombre, sus parámetros y cómo las salidas de los Steps anteriores pasan a los posteriores. Hacer referencia a una definición almacenada evita enviar las Instructions completas en cada solicitud de creación, pero no hace que el flujo de trabajo sea confidencial: Assembly Status puede exponer template y merged_params. Las propiedades proporcionadas en params al realizar la solicitud, excepto el propio allow_steps_override, se incorporan de forma recursiva al Template cargado, con prioridad sobre sus valores y sujetas a su política de sobrescritura de Steps. Esa combinación también permite variaciones en tiempo de ejecución. Los Templates se sitúan entre las solicitudes de la aplicación y la ejecución de las Assemblies, por lo que la gestión de sus cambios forma parte del contrato de integración.
Datos clave
- 1Los nombres de los Steps forman referencias dentro de las Assembly Instructions, por lo que cambiar el nombre de un Step puede romper las relaciones de
usecon Steps posteriores, incluso cuando cada operación individual sigue siendo sintácticamente válida. - 2Un
template_idselecciona instrucciones almacenadas, pero no autentica por sí solo una solicitud a la API; la autenticación de la cuenta y cualquier requisito de firma de solicitudes siguen siendo controles independientes. - 3Establece
allow_steps_overrideenfalseen el Template almacenado para rechazar las solicitudes que también proporcionen Steps. Otros parámetros de la solicitud aún pueden sobrescribir los valores almacenados. Exige Signature Authentication para las solicitudes con Auth Key y haz que un back end de confianza firme únicamente los parámetros aprobados; los tokens Bearer válidos eluden ese requisito y siguen sujetos a sus ámbitos y restricciones de audiencia. Las firmas cubrenparamsserializado, no los campos independientes del formulario de subida. Esos campos sin firmar rellenan${fields.*}y sobrescriben los valores firmados defieldsque tengan el mismo nombre, por lo que estos controles por sí solos no protegen las entradas dinámicas. No derives de esos campos los ajustes que quienes realizan las solicitudes no deben elegir. - 4Los Templates creados en un Workspace no permiten fijar una versión. Para realizar de forma segura un cambio incompatible con versiones anteriores, crea un nuevo Template con su propio
template_idy haz que quienes realizan las llamadas pasen a usarlo. Solo los Builtin Templates de Transloadit tienen versiones gestionadas por Transloadit.
Cuándo son importantes los Templates
Usa un Template para centralizar los cambios del flujo de trabajo y evitar enviar las Assembly Instructions completas en cada solicitud de creación. Establece allow_steps_override en false para impedir que se sobrescriban los Steps y exige Signature Authentication con un proceso de firma de confianza para las solicitudes con Auth Key. Estos controles no restringen los campos de subida sin firmar ni sustituyen las restricciones de ámbito de los tokens Bearer, así que revisa por separado las entradas dinámicas. Actualizar un Template compartido puede afectar a todos los clientes que lo utilizan, por lo que los cambios incompatibles pueden requerir un Template nuevo.