O que é o Assembly Status?
O Assembly Status da Transloadit é a representação JSON de uma Assembly. Ele inclui o identificador da Assembly, os uploads, os resultados, os dados de tempo de execução e as informações necessárias para localizar os arquivos de resultado.
Como funciona o Assembly Status
A representação de estado é o retrato canônico do processamento de uma Assembly no momento em que é produzida. A Transloadit usa esse mesmo formato nas respostas de criação de Assemblies, na URL de status da Assembly e nos payloads de notificações, reunindo o estado do ciclo de vida, informações de tempo, registros de entrada, saídas dos Steps, erros e locais dos resultados em um único documento legível por máquina. Retratos intermediários podem mudar à medida que as ramificações terminam, enquanto retratos finais permitem a ingestão durável dos resultados. Um back-end normalmente normaliza esse documento para seu próprio modelo de tarefas e mantém os identificadores para diagnósticos de suporte.
Informações essenciais
- 1Uploads e resultados gerados são coleções separadas na resposta, permitindo que os clientes distingam os registros de origem enviados dos arquivos derivados produzidos pelos Steps.
- 2As entradas de resultados são organizadas por nome do Step. Por isso, os consumidores devem se vincular à ramificação desejada do fluxo de trabalho, em vez de presumir que o primeiro arquivo retornado seja o ativo desejado.
- 3Clientes que fazem consultas periódicas precisam reconhecer explicitamente os estados finais de sucesso e falha; a presença de metadados parciais ou de alguns arquivos de resultado não comprova que todo o grafo foi concluído com sucesso.
Quando o Assembly Status é importante
Obtenha o documento pela URL de status da Assembly para verificar a conclusão, coletar URLs de resultados ou diagnosticar um Step com falha. O mesmo documento é retornado quando uma Assembly é criada, e esse documento é entregue nas Assembly Notifications. Não trate um retrato de um estado ainda em andamento como definitivo e trate os estados finais de falha antes de consumir os resultados.