Skip to main content
O armazenamento permite organizar arquivos da conta em pastas, preparar uploads assinados, enviar arquivos pelo serviço de upload e gerar links temporários de download. Use este recurso quando sua integração precisar manter documentos, planilhas, PDFs ou outros arquivos dentro do espaço de storage contratado.
O envio binário do arquivo não acontece na URL base da API principal. Primeiro prepare o upload na API, depois envie o arquivo para https://upload.lazydata.com.br/storage.

Fluxo principal

1

Liste ou crie uma pasta

Use a raiz ou uma pasta existente como destino do arquivo.
2

Prepare o upload

Informe nome e pasta de destino para receber upload_url, signature, expiração e limite.
3

Envie o arquivo

Faça o upload para upload.lazydata.com.br/storage usando a assinatura temporária.
4

Use o arquivo

Liste, renomeie, gere link de download ou exclua o item conforme necessário.

Endpoints

RecursoMétodoEndpoint
Listar itensGET/v1/storage/items
Criar pastaPOST/v1/storage/folders
Preparar uploadPOST/v1/storage/uploads
Enviar arquivoPOSThttps://upload.lazydata.com.br/storage
Gerar downloadGET/v1/storage/files/{file_id}/download
Renomear itemPATCH/v1/storage/items/{item_type}/{item_id}
Excluir itemDELETE/v1/storage/items/{item_type}/{item_id}

Tipos de item

TipoDescrição
folderPasta usada para organizar arquivos e outras pastas.
fileArquivo enviado e salvo no armazenamento.

Status de arquivo

StatusDescrição
waiting_uploadRegistro criado e aguardando envio do arquivo.
receiving_uploadUpload em andamento.
uploadedArquivo recebido e salvo com sucesso.
failedUpload falhou ou foi recusado.
deletingExclusão solicitada e em processamento.
deletedItem excluído.
delete_failedFalha ao remover o arquivo do storage.

Limites

ItemRegra
Tamanho máximo por arquivoAté 1024 MB.
Quantidade por listagemAté 100 itens por página.
Espaço disponívelDefinido pelo plano da conta.
Nome duplicadoNão é permitido ter dois arquivos ou duas pastas com o mesmo nome na mesma pasta.

Próximos passos

Listar itens

Navegue por pastas, arquivos, breadcrumbs e uso do storage.

Preparar upload

Gere assinatura temporária para enviar um arquivo.

Upload do arquivo

Envie o binário para upload.lazydata.com.br.

Gerar download

Gere um link temporário para baixar um arquivo.