O que é um Builtin Template?
Um Builtin Template é um Template versionado, mantido pela Transloadit e armazenado na API2. Ele é referenciado por um slug builtin/, como builtin/encode-hls-video@latest.
Como funcionam os Builtin Templates
Uma requisição de Assembly pode apontar para um grafo de processamento fornecido pela plataforma em vez de incluir ou manter um Template personalizado equivalente. O serviço resolve o identificador do Builtin Template e sua versão e, em seguida, executa a sequência mantida pela plataforma com as entradas e os parâmetros compatíveis fornecidos por quem faz a chamada. Isso coloca a manutenção do fluxo de trabalho sob responsabilidade da plataforma, enquanto a seleção de versão continua importante para testes, repetibilidade e implantação controlada em integrações de produção.
Informações essenciais
- 1Os identificadores de Builtin Templates ocupam o namespace
builtin/, e um sufixo após@seleciona um alias de lançamento ou uma versão, em vez de fazer parte do nome de um arquivo enviado por upload. - 2Uma referência a
@latesté intencionalmente mutável, portanto o mesmo código cliente pode passar a apontar para um grafo mantido mais recente; uma versão fixada fornece uma dependência estável para o fluxo de trabalho. - 3O grafo integrado define os Steps de processamento, não a mídia de quem faz a chamada. A criação da Assembly ainda precisa fornecer entradas válidas e todos os parâmetros exigidos por aquele fluxo de trabalho específico.
Quando os Builtin Templates são importantes
Faça referência a um Builtin Template quando o fluxo de trabalho mantido por ele corresponder aos Steps de processamento necessários. Fixe uma versão específica quando a reprodutibilidade for importante, pois @latest pode incorporar alterações posteriores.