O que é o Sync Mode?
O Sync Mode é um modo de operação da Transloadit no qual o cliente aguarda a conclusão da transferência e do processamento dos arquivos antes de receber os resultados finais da Assembly. Portanto, a requisição permanece aberta durante todo o fluxo de trabalho.
Como o Sync Mode funciona
No Sync Mode da Transloadit, o envio e o status da Assembly concluída fazem parte de uma única troca bloqueante de requisição e resposta, do ponto de vista de quem faz a chamada. A conexão permanece ocupada enquanto os uploads e os Steps de processamento são executados, após o que o resultado final pode ser consumido imediatamente. Esse acoplamento simplifica integrações curtas e sequenciais, mas faz com que a duração do fluxo de trabalho exija atenção aos tempos limite de HTTP e à capacidade de conexões. Seu lugar é na fronteira de orquestração da API, enquanto integrações assíncronas armazenam um identificador da Assembly e recebem ou consultam sua conclusão posteriormente.
Informações essenciais
- 1O processamento de uma Assembly pode continuar além do prazo da requisição imposto por um intermediário, mesmo que quem fez a chamada receba um erro de tempo limite. Por isso, a lógica de novas tentativas deve evitar presumir que a ausência de uma resposta síncrona significa que nenhuma Assembly foi criada.
- 2Os limites de tempo do navegador, do proxy reverso, do balanceador de carga e do ambiente serverless podem ser diferentes; o menor limite determina se uma chamada síncrona permanece ativa durante uma transcodificação demorada ou uma importação remota.
- 3O Sync Mode altera a forma como a conclusão é entregue, sem alterar a semântica dos próprios Assembly Steps; a resolução de dependências e a estrutura dos resultados continuam sendo propriedades do fluxo de trabalho configurado.
Quando o Sync Mode é importante
Escolha o Sync Mode quando quem faz a chamada puder aguardar com segurança e precisar dos resultados concluídos antes de continuar. Um processamento longo ou de duração variável pode exceder os tempos limite do cliente, do proxy ou do servidor, tornando o tratamento assíncrono mais confiável.