Skip to main content
O upload de arquivos na Lazy Data é usado em fluxos que precisam enviar arquivos para processamento ou armazenamento. Atualmente, os principais usos são:
  • Enriquecimento: envio de bases para processamento em massa.
  • Armazenamento: envio de arquivos para organização no espaço de storage da conta.
O upload não deve ser feito enviando arquivos diretamente para endpoints comuns da API. O fluxo recomendado usa uma assinatura temporária de upload.

​
Fluxo geral

O fluxo de upload é dividido em etapas para manter segurança, controle de tamanho e rastreabilidade.
1

Solicite a assinatura de upload

A aplicação informa o destino do upload, nome do arquivo, tamanho e tipo de conteúdo.
2

Envie o arquivo para a URL assinada

Use a URL temporária retornada para enviar o arquivo diretamente ao storage.
3

Confirme ou use o arquivo no recurso desejado

Depois do envio, vincule o arquivo ao fluxo de enriquecimento ou armazenamento.

​
Quando usar upload

​
Segurança

As URLs assinadas são temporárias e devem ser usadas apenas para o arquivo informado na solicitação. Boas práticas:
  • Gere uma assinatura por arquivo.
  • Não reutilize URLs assinadas.
  • Não exponha a URL assinada em logs públicos.
  • Valide tamanho e tipo do arquivo antes de solicitar a assinatura.
  • Envie o arquivo logo após obter a assinatura.
  • Trate expiração da assinatura solicitando uma nova URL.

​
Limites

Mesmo que o endpoint de assinatura aceite um arquivo grande, o recurso final pode aplicar regras próprias. Por exemplo, enriquecimento pode restringir formatos de planilha, enquanto armazenamento pode aceitar mais tipos de arquivo.

​
Enriquecimento

Use upload para enriquecimento quando precisar enviar uma base que será processada em massa. Normalmente esse fluxo envolve:
  1. Enviar o arquivo de entrada.
  2. Criar ou configurar o enriquecimento.
  3. Mapear colunas, datasets e opções de processamento.
  4. Acompanhar execução.
  5. Baixar o arquivo final quando estiver concluído.

Upload para enriquecimento

Veja formatos aceitos, regras de arquivo e como o upload se conecta ao fluxo de enriquecimento.

​
Armazenamento

Use upload para armazenamento quando quiser salvar arquivos no espaço da conta. Normalmente esse fluxo envolve:
  1. Selecionar a pasta de destino.
  2. Solicitar a assinatura de upload.
  3. Enviar o arquivo.
  4. Registrar ou confirmar o arquivo no storage.
  5. Listar, renomear, baixar ou apagar o arquivo posteriormente.

Upload para armazenamento

Veja como enviar arquivos para pastas e manter os dados organizados no armazenamento da conta.

​
Metadados comuns

Ao solicitar uma assinatura de upload, normalmente serão necessários metadados como:
Os campos exatos podem variar conforme o endpoint específico de enriquecimento ou armazenamento.

​
Respostas e erros

Uploads podem falhar por motivos como:

Códigos de erro

Consulte os erros específicos relacionados a upload de arquivos.

​
Boas práticas

  • Calcule o tamanho do arquivo antes de solicitar a assinatura.
  • Use o content_type real do arquivo.
  • Para enriquecimento, valide cabeçalhos e colunas antes do envio.
  • Para armazenamento, confirme se a pasta de destino existe.
  • Não tente enviar novamente para uma URL assinada expirada.
  • Se o upload falhar no envio para o storage, solicite uma nova assinatura.
  • Mantenha o identificador retornado pelo fluxo para vincular o arquivo ao recurso correto.