Desvendando o jargão da Transloadit: um guia completo
Está começando com a Transloadit e se perdendo no mar de termos técnicos? Não se preocupe, estamos aqui para ajudar! Neste post, vamos passar por alguns jargões específicos da Transloadit para que você se sinta confiante na próxima vez que navegar pela documentação da Transloadit.
Robots e Jobs
Nos bastidores, a Transloadit funciona executando ferramentas como o FFmpeg em um arquivo. Executar uma ferramenta assim cria um Job, que é a menor unidade lógica sobre a qual todo o resto é construído.
No entanto, os Jobs não se executam sozinhos, e é aí que entram os nossos Robots. Cada Robot do nosso arsenal é especializado em uma única tarefa, e há um número infinito de combinações possíveis de Robots que podem criar funcionalidades complexas, como um gerador de cartões musicais (English).
Templates, Assemblies e Assembly Instructions
Um único Robot já consegue fazer coisas impressionantes, mas quando começamos a combinar vários Robots em uma linha de montagem (ou, como gostamos de dizer, em Assembly Instructions), conseguimos criar coisas realmente incríveis. Cada Robot executa um único Step do processo, o que resulta, no fim, em uma funcionalidade maior do que a soma de qualquer parte individual.
Os servidores da Transloadit podem então interpretar suas Assembly Instructions e executar as ferramentas de back-end necessárias para gerar seus arquivos transcodificados. Usamos o termo Assembly para nos referir a uma única execução das Assembly Instructions.
Claro que nem sempre é ideal enviar um novo conjunto de Assembly Instructions toda vez que você quiser criar uma Assembly. Foi por isso que criamos os Templates. Com os Templates, basta indicar à Transloadit o nome do seu Template, e a partir daí seguiremos a receita JSON que você elaborou com cuidado. Destacamos alguns dos benefícios de usar Templates em um post recente do blog: 5 maneiras de aproveitar ao máximo a Transloadit.
Síncrono vs. assíncrono
Por padrão, a Transloadit retorna o estado atual da Assembly como parte do Assembly Status JSON, que você pode assinar e consultar periodicamente para verificar a conclusão da Assembly. Isso se chama usar a Transloadit de forma síncrona ou no Sync Mode.
No entanto, também oferecemos a opção de interagir com a Transloadit de forma assíncrona. Informe um
notify_url e defina waitForEncoding como false, e enviaremos uma requisição POST para o seu
back-end quando a Assembly terminar a codificação. Assim, seu usuário não fica bloqueado
enquanto seus servidores aguardam o fim da transcodificação. Você pode saber mais sobre como configurar
o Async
Mode e verificar as assinaturas das notificações no nosso
guia de webhooks.
Outro recurso útil, disponível independentemente do modo síncrono ou assíncrono, são os Assembly Replays. Se tiver ocorrido um problema durante a execução da sua Assembly e o upload dos arquivos já tiver sido concluído com sucesso, a Transloadit pode reexecutar a Assembly em até 24 horas. Isso acontece automaticamente em caso de falha no servidor, mas também pode ser acionado manualmente pelo console da Transloadit.
Por hoje é só, pessoal!
Com isso, chegamos ao fim do nosso tour relâmpago pela terminologia da Transloadit.
Esperamos que este post tenha esclarecido qualquer dúvida que você possa ter tido. Como sempre, porém, entre em contato conosco se precisar de orientação sobre qualquer recurso da Transloadit.