Skip to main content
O upload de arquivos na Lazy Data usa um fluxo com assinatura temporária para garantir que cada envio seja autorizado antes de o arquivo ser recebido e processado. Esse fluxo é usado em recursos que precisam receber arquivos maiores ou arquivos que serão processados em segundo plano.

​
Onde o upload é usado

Atualmente, o upload de arquivos é usado em dois fluxos principais:

Enriquecimento

Envio de bases CSV, XLS ou XLSX para enriquecimento de CPF ou CNPJ.

Armazenamento

Envio de arquivos para o espaço de armazenamento da conta.

​
Como funciona

O fluxo geral é dividido em três etapas:
  1. A aplicação solicita uma assinatura temporária de upload.
  2. O arquivo é enviado para o endpoint de upload usando essa assinatura.
  3. A Lazy Data valida, processa e registra o arquivo conforme o recurso de destino.

​
Assinatura temporária

Antes de enviar um arquivo, é necessário obter uma assinatura de upload. A assinatura define:
  • conta responsável pelo envio;
  • recurso de destino;
  • validade da autorização;
  • operação permitida;
  • identificador relacionado ao upload;
  • contexto necessário para validação.
A assinatura deve ser usada somente para o upload solicitado.

​
Domínio de upload

Os arquivos são enviados para um domínio dedicado de upload. Exemplo: 
POST https://upload.lazydata.com.br/enrichment
Em ambiente local ou sandbox, o domínio pode variar conforme a configuração do ambiente.

​
Header de assinatura

A assinatura deve ser enviada no header da requisição. Exemplo: 
x-upload-signature: assinatura_temporaria

​
Limite por arquivo

O limite atual por arquivo é de até 1 GB. Arquivos acima desse limite são recusados. 
Limite por arquivo: 1 GB

​
Validações realizadas

Durante o upload, a Lazy Data pode validar:
  • assinatura;
  • validade da assinatura;
  • permissão da conta;
  • recurso de destino;
  • tamanho do arquivo;
  • formato permitido;
  • integridade do arquivo;
  • duplicidade;
  • disponibilidade para processamento.
As validações específicas dependem do tipo de upload.

​
Resposta padrão

Quando o arquivo é aceito, a API retorna uma resposta no padrão: 
{
  "code": 200,
  "message": "Arquivo recebido com sucesso.",
  "result": {
    "id": "b3a1f6da-2c3e-47a1-95b3-2d51cf451111",
    "status": "processing"
  }
}
Em alguns fluxos, o arquivo pode continuar sendo analisado em segundo plano após o upload.

​
Processamento em segundo plano

Alguns uploads exigem processamento posterior. Exemplos:
  • análise de colunas em arquivos de enriquecimento;
  • cálculo de linhas;
  • identificação de CPF ou CNPJ;
  • armazenamento definitivo;
  • registro de metadados;
  • atualização do status do recurso.
Nesses casos, a resposta inicial pode indicar que o arquivo foi recebido e que o processamento continua em andamento.

​
Falhas comuns

Possíveis causas de falha no upload:
  • assinatura ausente;
  • assinatura inválida;
  • assinatura expirada;
  • arquivo acima do limite;
  • formato não permitido;
  • recurso de destino não encontrado;
  • arquivo já enviado;
  • falha no armazenamento;
  • interrupção de conexão.
Consulte os códigos de erro de upload:

Códigos de erro de upload

Veja os erros possíveis durante o envio de arquivos.

​
Boas práticas

  • Solicite uma nova assinatura antes de cada upload.
  • Não reutilize assinaturas expiradas.
  • Não envie arquivos acima de 1 GB.
  • Mantenha a página aberta durante uploads grandes.
  • Use conexão estável para arquivos grandes.
  • Aguarde o status final antes de iniciar etapas dependentes do arquivo.

​
Próximos passos

Upload para enriquecimento

Veja o fluxo de envio de bases para enriquecimento.

Upload para armazenamento

Veja o fluxo de envio de arquivos para o armazenamento.