Visão Geral
Quando você cria um relatório, a API retorna uma URL assinada do S3 (uploadUrl
) que permite fazer upload de arquivos diretamente para o armazenamento da Base39.
Exemplo Simples
Upload com JavaScript/TypeScript
Exemplo Básico com Fetch
Exemplo com FormData e Múltiplos Arquivos
Upload com Python
Opções Avançadas
Monitoramento de Progresso
Upload com Retry Automático
Validação de Arquivo Antes do Upload
Limitações e Boas Práticas
Tamanho dos Arquivos
- Tamanho máximo recomendado: 10MB por arquivo
- Para arquivos maiores, considere dividir ou comprimir
Expiração da URL
- URLs assinadas expiram após 15 minutos
- Se o upload falhar, crie um novo relatório para obter uma nova URL
Content-Type
- Sempre defina o
Content-Type
correto no header do upload - Tipos comuns:
application/pdf
- Documentos PDFimage/jpeg
- Imagens JPEGimage/png
- Imagens PNGtext/csv
- Arquivos CSVapplication/json
- Arquivos JSON
Segurança
- Nunca compartilhe URLs assinadas publicamente
- URLs são de uso único e temporárias
- Validate sempre os arquivos no lado do cliente antes do upload