Skip to main content
O upload para armazenamento é usado para enviar arquivos ao espaço de arquivos da conta Lazy Data. Após o upload, o arquivo fica disponível na pasta selecionada e pode ser baixado, renomeado ou excluído pelo painel.

​
Endpoint

POST https://upload.lazydata.com.br/storage
Em ambientes locais ou sandbox, o domínio pode variar conforme a configuração da integração.

​
Header obrigatório

A requisição deve enviar a assinatura temporária de upload no header. 
x-upload-signature: assinatura_temporaria

​
Como obter a assinatura

A assinatura é gerada antes do upload pelo painel ou pela integração autorizada. Ela define:
  • conta responsável;
  • pasta de destino;
  • operação permitida;
  • validade da autorização;
  • contexto de armazenamento.
A assinatura deve ser usada somente para o upload solicitado.

​
Envio do arquivo

O arquivo deve ser enviado como multipart/form-data. Exemplo conceitual: 
POST /storage HTTP/1.1
Host: upload.lazydata.com.br
x-upload-signature: assinatura_temporaria
Content-Type: multipart/form-data
Campo do arquivo: 
file

​
Limite por arquivo

Cada arquivo pode ter até 1 GB. Arquivos acima desse limite são recusados.

​
Pasta de destino

O arquivo é salvo na pasta definida pela assinatura. Se a pasta de destino não existir, estiver indisponível ou não pertencer à conta autorizada, o upload é recusado.

​
Validações realizadas

Durante o upload, a Lazy Data valida:
  • assinatura temporária;
  • validade da assinatura;
  • conta responsável;
  • pasta de destino;
  • limite de armazenamento da conta;
  • tamanho do arquivo;
  • nome do arquivo;
  • tipo de conteúdo;
  • integridade;
  • duplicidade quando aplicável.

​
Registro do arquivo

Após o upload, a Lazy Data registra os metadados do arquivo. Exemplo de metadados: 
{
  "id": "8c30d4a1-b1ac-4d18-a8f9-b4cb77771111",
  "name": "relatorio.pdf",
  "extension": "pdf",
  "content_type": "application/pdf",
  "size": 187392,
  "folder_id": "1e6c59aa-1b8e-4cf8-becb-49b2c1111111",
  "uploaded_at": "2026-06-21T09:00:00-03:00"
}

​
Resposta de upload concluído

Quando o arquivo é salvo com sucesso, a API retorna: 
{
  "code": 200,
  "message": "Arquivo enviado com sucesso.",
  "result": {
    "id": "8c30d4a1-b1ac-4d18-a8f9-b4cb77771111",
    "name": "relatorio.pdf",
    "extension": "pdf",
    "content_type": "application/pdf",
    "size": 187392,
    "status": "available"
  }
}

​
Disponibilidade no painel

Após o upload, o arquivo aparece na pasta de destino. No painel, é possível:
  • baixar o arquivo;
  • renomear o arquivo;
  • excluir o arquivo;
  • organizar arquivos em pastas;
  • visualizar metadados básicos.

​
Ícones por tipo

A interface pode exibir ícones diferentes conforme o tipo do arquivo. Exemplos:
TipoExtensões comuns
Imagem.jpg, .jpeg, .png, .webp
PDF.pdf
Planilha.csv, .xls, .xlsx
Documento.doc, .docx, .txt
Compactado.zip, .rar, .7z
GenéricoOutros formatos permitidos

​
Falhas comuns

Possíveis falhas no upload para armazenamento:
  • assinatura ausente;
  • assinatura inválida;
  • assinatura expirada;
  • pasta de destino não encontrada;
  • arquivo acima de 1 GB;
  • limite de armazenamento excedido;
  • falha ao salvar o arquivo;
  • conexão interrompida;
  • arquivo vazio ou inválido.
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

  • Envie arquivos para a pasta correta.
  • Use nomes claros e objetivos.
  • Verifique o espaço disponível antes de arquivos grandes.
  • Evite enviar arquivos duplicados.
  • Aguarde o upload finalizar antes de atualizar a página.
  • Renomeie arquivos quando necessário para facilitar a organização.

​
Próximos passos

Armazenamento

Entenda como organizar pastas, arquivos e limites de armazenamento.