IntegrationsGuides
Upload de Arquivos
Fluxo de URL presigned em dois passos para upload de anexos em documentos.
Os anexos do Carrot utilizam um fluxo de URL presigned em dois passos.
Passo 1: Solicitar URL de upload
Chamada:
PUT /documents/{documentId}/attachments/{fileName}
Com:
contentLength(bytes)contentType(tipo MIME)
Referência: API de Attachments.
Passo 2: Fazer upload diretamente no storage
Use a URL retornada e envie os bytes do arquivo com o mesmo tipo MIME.
- Nenhum bearer token é necessário na chamada de upload presigned.
- Mantenha os headers da requisição de upload consistentes com o payload do passo 1.
Práticas recomendadas
- Aplique o limite de 10 MB no lado do cliente antes do upload — veja Limites de Requisição.
- Use nomes de arquivo determinísticos quando possível.
- Persista os nomes dos arquivos enviados para referenciá-los depois nos metadados de eventos.
Fluxo de download
Solicite uma URL temporária de download via:
GET /documents/{documentId}/attachments/{fileName}
Em seguida, faça o fetch da URL retornada.
Guias relacionados:
- Submissão de um MassID — upload de arquivos no contexto do ciclo de vida completo de um documento.